Struct aws_sdk_ec2::client::fluent_builders::ModifyInstancePlacement

pub struct ModifyInstancePlacement { /* private fields */ }

Fluent builder constructing a request to ModifyInstancePlacement.

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.

• 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.

Implementations

impl ModifyInstancePlacement

pub async fn send(
    self
) -> Result<ModifyInstancePlacementOutput, SdkError<ModifyInstancePlacementError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn affinity(self, input: Affinity) -> Self

The affinity setting for the instance.

pub fn set_affinity(self, input: Option<Affinity>) -> Self

The affinity setting for the instance.

pub fn group_name(self, input: impl Into<String>) -> Self

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 ("").

pub fn set_group_name(self, input: Option<String>) -> Self

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 ("").

pub fn host_id(self, input: impl Into<String>) -> Self

The ID of the Dedicated Host with which to associate the instance.

pub fn set_host_id(self, input: Option<String>) -> Self

The ID of the Dedicated Host with which to associate the instance.

pub fn instance_id(self, input: impl Into<String>) -> Self

The ID of the instance that you are modifying.

pub fn set_instance_id(self, input: Option<String>) -> Self

The ID of the instance that you are modifying.

pub fn tenancy(self, input: HostTenancy) -> Self

The tenancy for the instance.

For T3 instances, you can't change the tenancy from dedicated to host, or from host to dedicated. Attempting to make one of these unsupported tenancy changes results in the InvalidTenancy error code.

pub fn set_tenancy(self, input: Option<HostTenancy>) -> Self

The tenancy for the instance.

For T3 instances, you can't change the tenancy from dedicated to host, or from host to dedicated. Attempting to make one of these unsupported tenancy changes results in the InvalidTenancy error code.

pub fn partition_number(self, input: i32) -> Self

The number of the partition in which to place the instance. Valid only if the placement group strategy is set to partition.

pub fn set_partition_number(self, input: Option<i32>) -> Self

The number of the partition in which to place the instance. Valid only if the placement group strategy is set to partition.

pub fn host_resource_group_arn(self, input: impl Into<String>) -> Self

The ARN of the host resource group in which to place the instance.

pub fn set_host_resource_group_arn(self, input: Option<String>) -> Self

The ARN of the host resource group in which to place the instance.

Trait Implementations

impl Clone for ModifyInstancePlacement

fn clone(&self) -> ModifyInstancePlacement

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ModifyInstancePlacement

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.