Struct aws_sdk_ec2::client::fluent_builders::ReleaseHosts

pub struct ReleaseHosts { /* private fields */ }

Fluent builder constructing a request to ReleaseHosts.

When you no longer want to use an On-Demand Dedicated Host it can be released. On-Demand billing is stopped and the host goes into released state. The host ID of Dedicated Hosts that have been released can no longer be specified in another request, for example, to modify the host. You must stop or terminate all instances on a host before it can be released.

When Dedicated Hosts are released, it may take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated Hosts. Wait a few minutes and then try again.

Released hosts still appear in a DescribeHosts response.

Implementations

impl ReleaseHosts

pub async fn customize(
    self
) -> Result<CustomizableOperation<ReleaseHosts, AwsResponseRetryClassifier>, SdkError<ReleaseHostsError>>

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<ReleaseHostsOutput, SdkError<ReleaseHostsError>>

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

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

The IDs of the Dedicated Hosts to release.

Trait Implementations

impl Clone for ReleaseHosts

fn clone(&self) -> ReleaseHosts

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ReleaseHosts

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

Formats the value using the given formatter.