modify_hosts

EC2.Client.modify_hosts(**kwargs)

Modify the auto-placement setting of a Dedicated Host. When auto-placement is enabled, any instances that you launch with a tenancy of host but without a specific host ID are placed onto any available Dedicated Host in your account that has auto-placement enabled. When auto-placement is disabled, you need to provide a host ID to have the instance launch onto a specific host. If no host ID is provided, the instance is launched onto a suitable host with auto-placement enabled.

You can also use this API action to modify a Dedicated Host to support either multiple instance types in an instance family, or to support a specific instance type only.

See also: AWS API Documentation

Request Syntax

response = client.modify_hosts(
    AutoPlacement='on'|'off',
    HostIds=[
        'string',
    ],
    HostRecovery='on'|'off',
    InstanceType='string',
    InstanceFamily='string',
    HostMaintenance='on'|'off'
)
Parameters
  • AutoPlacement (string) -- Specify whether to enable or disable auto-placement.
  • HostIds (list) --

    [REQUIRED]

    The IDs of the Dedicated Hosts to modify.

    • (string) --
  • HostRecovery (string) -- Indicates whether to enable or disable host recovery for the Dedicated Host. For more information, see Host recovery in the Amazon EC2 User Guide .
  • InstanceType (string) --

    Specifies the instance type to be supported by the Dedicated Host. Specify this parameter to modify a Dedicated Host to support only a specific instance type.

    If you want to modify a Dedicated Host to support multiple instance types in its current instance family, omit this parameter and specify InstanceFamily instead. You cannot specify InstanceType and InstanceFamily in the same request.

  • InstanceFamily (string) --

    Specifies the instance family to be supported by the Dedicated Host. Specify this parameter to modify a Dedicated Host to support multiple instance types within its current instance family.

    If you want to modify a Dedicated Host to support a specific instance type only, omit this parameter and specify InstanceType instead. You cannot specify InstanceFamily and InstanceType in the same request.

  • HostMaintenance (string) -- Indicates whether to enable or disable host maintenance for the Dedicated Host. For more information, see Host maintenance in the Amazon EC2 User Guide .
Return type

dict

Returns

Response Syntax

{
    'Successful': [
        'string',
    ],
    'Unsuccessful': [
        {
            'Error': {
                'Code': 'string',
                'Message': 'string'
            },
            'ResourceId': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • Successful (list) --

      The IDs of the Dedicated Hosts that were successfully modified.

      • (string) --
    • Unsuccessful (list) --

      The IDs of the Dedicated Hosts that could not be modified. Check whether the setting you requested can be used.

      • (dict) --

        Information about items that were not successfully processed in a batch call.

        • Error (dict) --

          Information about the error.

          • Code (string) --

            The error code.

          • Message (string) --

            The error message accompanying the error code.

        • ResourceId (string) --

          The ID of the resource.