ModifyInstancePlacement
In this article:
ModifyInstancePlacement#
Description#
Changes placement parameters for a specified instance.
Request Parameters#
Required parameters#
instanceId — The ID of the instance.
Type: String
Required: Yes
Optional parameters#
Affinity — The instance restart rule.
Type: String
Required: No
Valid values:
default
|host
GroupId — The placement group ID.
Type: String
Required: No
GroupName — The name of the placement group in which to place the instance. To remove an instance from its current placement group, pass an empty string
""
in GroupName.Type: String
Required: No
Valid values: ASCII, except
\<>:/
Length constraints: from 1 to 255 symbols
HostId — The dedicated host ID. To remove an instance from the dedicated host, pass an empty string
""
to HostId.Type: String
Required: No
Tenancy — The type of placement for the instance.
Type: String
Required: No
Valid values:
default
|host
Response Elements#
requestId — The request ID.
Type: String
return —
True
is returned if the request succeeds and an error otherwise.Type: Boolean
Examples#
c2-ec2 ModifyInstancePlacement InstanceId <instance_id> GroupName ""
c2-ec2 ModifyInstancePlacement InstanceId <instance_id> GroupName <group_name>
c2-ec2 ModifyInstancePlacement InstanceId <instance_id> HostId <host_id>
c2-ec2 ModifyInstancePlacement InstanceId <instance_id> HostId ""