Struct aws_sdk_ec2::client::fluent_builders::DeregisterImage

pub struct DeregisterImage { /* private fields */ }

Fluent builder constructing a request to DeregisterImage.

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

If you deregister an AMI that matches a Recycle Bin retention rule, the AMI is retained in the Recycle Bin for the specified retention period. For more information, see Recycle Bin in the Amazon Elastic Compute Cloud User Guide.

When you deregister an AMI, it doesn't affect any instances that you've already launched from the AMI. You'll continue to incur usage costs for those instances until you terminate them.

When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was created for the root volume of the instance during the AMI creation process. When you deregister an instance store-backed AMI, it doesn't affect the files that you uploaded to Amazon S3 when you created the AMI.

Implementations

impl DeregisterImage

pub async fn customize(
    self
) -> Result<CustomizableOperation<DeregisterImage, AwsResponseRetryClassifier>, SdkError<DeregisterImageError>>

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<DeregisterImageOutput, SdkError<DeregisterImageError>>

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 image_id(self, input: impl Into<String>) -> Self

The ID of the AMI.

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

The ID of the AMI.

pub fn dry_run(self, input: bool) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

pub fn set_dry_run(self, input: Option<bool>) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Trait Implementations

impl Clone for DeregisterImage

fn clone(&self) -> DeregisterImage

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DeregisterImage

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

Formats the value using the given formatter.