Struct aws_sdk_ec2::client::fluent_builders::CreateSnapshots

pub struct CreateSnapshots { /* private fields */ }

Fluent builder constructing a request to CreateSnapshots.

Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3. Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot each that is crash-consistent across the instance.

You can include all of the volumes currently attached to the instance, or you can exclude the root volume or specific data (non-root) volumes from the multi-volume snapshot set.

You can create multi-volume snapshots of instances in a Region and instances on an Outpost. If you create snapshots from an instance in a Region, the snapshots must be stored in the same Region as the instance. If you create snapshots from an instance on an Outpost, the snapshots can be stored on the same Outpost as the instance, or in the Region for that Outpost.

Implementations

impl CreateSnapshots

pub async fn customize(
    self
) -> Result<CustomizableOperation<CreateSnapshots, AwsResponseRetryClassifier>, SdkError<CreateSnapshotsError>>

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<CreateSnapshotsOutput, SdkError<CreateSnapshotsError>>

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

A description propagated to every snapshot specified by the instance.

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

A description propagated to every snapshot specified by the instance.

pub fn instance_specification(self, input: InstanceSpecification) -> Self

The instance to specify which volumes should be included in the snapshots.

pub fn set_instance_specification(
    self,
    input: Option<InstanceSpecification>
) -> Self

The instance to specify which volumes should be included in the snapshots.

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

The Amazon Resource Name (ARN) of the Outpost on which to create the local snapshots.

• To create snapshots from an instance in a Region, omit this parameter. The snapshots are created in the same Region as the instance.

• To create snapshots from an instance on an Outpost and store the snapshots in the Region, omit this parameter. The snapshots are created in the Region for the Outpost.

• To create snapshots from an instance on an Outpost and store the snapshots on an Outpost, specify the ARN of the destination Outpost. The snapshots must be created on the same Outpost as the instance.

For more information, see Create multi-volume local snapshots from instances on an Outpost in the Amazon Elastic Compute Cloud User Guide.

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

The Amazon Resource Name (ARN) of the Outpost on which to create the local snapshots.

• To create snapshots from an instance in a Region, omit this parameter. The snapshots are created in the same Region as the instance.

• To create snapshots from an instance on an Outpost and store the snapshots in the Region, omit this parameter. The snapshots are created in the Region for the Outpost.

• To create snapshots from an instance on an Outpost and store the snapshots on an Outpost, specify the ARN of the destination Outpost. The snapshots must be created on the same Outpost as the instance.

For more information, see Create multi-volume local snapshots from instances on an Outpost in the Amazon Elastic Compute Cloud User Guide.

pub fn tag_specifications(self, input: TagSpecification) -> Self

Appends an item to TagSpecifications.

To override the contents of this collection use set_tag_specifications.

Tags to apply to every snapshot specified by the instance.

pub fn set_tag_specifications(self, input: Option<Vec<TagSpecification>>) -> Self

Tags to apply to every snapshot specified by the instance.

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.

pub fn copy_tags_from_source(self, input: CopyTagsFromSource) -> Self

Copies the tags from the specified volume to corresponding snapshot.

pub fn set_copy_tags_from_source(self, input: Option<CopyTagsFromSource>) -> Self

Copies the tags from the specified volume to corresponding snapshot.

Trait Implementations

impl Clone for CreateSnapshots

fn clone(&self) -> CreateSnapshots

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CreateSnapshots

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

Formats the value using the given formatter.