Struct aws_sdk_ec2::client::fluent_builders::ModifyHosts

pub struct ModifyHosts { /* private fields */ }

Fluent builder constructing a request to 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.

Implementations

impl ModifyHosts

pub async fn customize(
    self
) -> Result<CustomizableOperation<ModifyHosts, AwsResponseRetryClassifier>, SdkError<ModifyHostsError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(self) -> Result<ModifyHostsOutput, SdkError<ModifyHostsError>>

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 auto_placement(self, input: AutoPlacement) -> Self

Specify whether to enable or disable auto-placement.

pub fn set_auto_placement(self, input: Option<AutoPlacement>) -> Self

Specify whether to enable or disable auto-placement.

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

Appends an item to HostIds.

To override the contents of this collection use set_host_ids.

The IDs of the Dedicated Hosts to modify.

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

The IDs of the Dedicated Hosts to modify.

pub fn host_recovery(self, input: HostRecovery) -> Self

Indicates whether to enable or disable host recovery for the Dedicated Host. For more information, see Host recovery in the Amazon EC2 User Guide.

pub fn set_host_recovery(self, input: Option<HostRecovery>) -> Self

Indicates whether to enable or disable host recovery for the Dedicated Host. For more information, see Host recovery in the Amazon EC2 User Guide.

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

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.

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

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.

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

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.

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

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.

Trait Implementations

impl Clone for ModifyHosts

fn clone(&self) -> ModifyHosts

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ModifyHosts

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

Formats the value using the given formatter.