Modifies the placement attributes for a specified instance. You can do the following:
Modify the affinity between an instance and a Dedicated Host.
When affinity is set to host
and the instance is not associated
with a specific Dedicated Host, the next time the instance is
launched, it is automatically associated with the host on which it
lands. If the instance is restarted or rebooted, this relationship
persists.
Change the Dedicated Host with which an instance is associated.
Change the instance tenancy of an instance from host
to
dedicated
, or from dedicated
to host
.
Move an instance to or from a placement group.
At least one attribute for affinity, host ID, tenancy, or placement group name must be specified in the request. Affinity and tenancy can be modified in the same request.
To modify the host ID, tenancy, placement group, or partition for an
instance, the instance must be in the stopped
state.
ec2_modify_instance_placement(Affinity, GroupName, HostId, InstanceId,
Tenancy, PartitionNumber, HostResourceGroupArn)
A list with the following syntax:
list(
Return = TRUE|FALSE
)
The affinity setting for the instance.
The name of the placement group in which to place the instance. For
spread placement groups, the instance must have a tenancy of default
.
For cluster and partition placement groups, the instance must have a
tenancy of default
or dedicated
.
To remove an instance from a placement group, specify an empty string ("").
The ID of the Dedicated Host with which to associate the instance.
[required] The ID of the instance that you are modifying.
The tenancy for the instance.
Reserved for future use.
The ARN of the host resource group in which to place the instance.
svc$modify_instance_placement(
Affinity = "default"|"host",
GroupName = "string",
HostId = "string",
InstanceId = "string",
Tenancy = "dedicated"|"host",
PartitionNumber = 123,
HostResourceGroupArn = "string"
)