/AWS1/CL_EC2=>MODIFYHOSTS()¶
About ModifyHosts¶
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.
Method Signature¶
IMPORTING¶
Required arguments:¶
IT_HOSTIDS TYPE /AWS1/CL_EC2REQHOSTIDLIST_W=>TT_REQUESTHOSTIDLIST TT_REQUESTHOSTIDLIST¶
The IDs of the Dedicated Hosts to modify.
Optional arguments:¶
IV_HOSTRECOVERY TYPE /AWS1/EC2HOSTRECOVERY /AWS1/EC2HOSTRECOVERY¶
Indicates whether to enable or disable host recovery for the Dedicated Host. For more information, see Host recovery in the Amazon EC2 User Guide.
IV_INSTANCETYPE TYPE /AWS1/EC2STRING /AWS1/EC2STRING¶
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.
IV_INSTANCEFAMILY TYPE /AWS1/EC2STRING /AWS1/EC2STRING¶
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.
IV_HOSTMAINTENANCE TYPE /AWS1/EC2HOSTMAINTENANCE /AWS1/EC2HOSTMAINTENANCE¶
Indicates whether to enable or disable host maintenance for the Dedicated Host. For more information, see Host maintenance in the Amazon EC2 User Guide.
IV_AUTOPLACEMENT TYPE /AWS1/EC2AUTOPLACEMENT /AWS1/EC2AUTOPLACEMENT¶
Specify whether to enable or disable auto-placement.