Struct aws_sdk_datasync::operation::create_location_s3::builders::CreateLocationS3FluentBuilder

pub struct CreateLocationS3FluentBuilder { /* private fields */ }

Fluent builder constructing a request to CreateLocationS3.

Creates a transfer location for an Amazon S3 bucket. DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you read the following topics:

• Storage class considerations with Amazon S3 locations

• Evaluating S3 request costs when using DataSync

For more information, see Configuring transfers with Amazon S3.

Implementations

impl CreateLocationS3FluentBuilder

pub fn as_input(&self) -> &CreateLocationS3InputBuilder

Access the CreateLocationS3 as a reference.

pub async fn send( self, ) -> Result<CreateLocationS3Output, SdkError<CreateLocationS3Error, HttpResponse>>

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 customize( self, ) -> CustomizableOperation<CreateLocationS3Output, CreateLocationS3Error, Self>

Consumes this builder, creating a customizable operation that can be modified before being sent.

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

Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).

DataSync can't transfer objects with a prefix that begins with a slash (/) or includes //, /./, or /../ patterns. For example:

• /photos

• photos//2006/January

• photos/./2006/February

• photos/../2006/March

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

Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).

DataSync can't transfer objects with a prefix that begins with a slash (/) or includes //, /./, or /../ patterns. For example:

• /photos

• photos//2006/January

• photos/./2006/February

• photos/../2006/March

pub fn get_subdirectory(&self) -> &Option<String>

Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).

DataSync can't transfer objects with a prefix that begins with a slash (/) or includes //, /./, or /../ patterns. For example:

• /photos

• photos//2006/January

• photos/./2006/February

• photos/../2006/March

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

Specifies the ARN of the S3 bucket that you want to use as a location. (When creating your DataSync task later, you specify whether this location is a transfer source or destination.)

If your S3 bucket is located on an Outposts resource, you must specify an Amazon S3 access point. For more information, see Managing data access with Amazon S3 access points in the Amazon S3 User Guide.

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

Specifies the ARN of the S3 bucket that you want to use as a location. (When creating your DataSync task later, you specify whether this location is a transfer source or destination.)

If your S3 bucket is located on an Outposts resource, you must specify an Amazon S3 access point. For more information, see Managing data access with Amazon S3 access points in the Amazon S3 User Guide.

pub fn get_s3_bucket_arn(&self) -> &Option<String>

Specifies the ARN of the S3 bucket that you want to use as a location. (When creating your DataSync task later, you specify whether this location is a transfer source or destination.)

If your S3 bucket is located on an Outposts resource, you must specify an Amazon S3 access point. For more information, see Managing data access with Amazon S3 access points in the Amazon S3 User Guide.

pub fn s3_storage_class(self, input: S3StorageClass) -> Self

Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.

For buckets in Amazon Web Services Regions, the storage class defaults to STANDARD. For buckets on Outposts, the storage class defaults to OUTPOSTS.

For more information, see Storage class considerations with Amazon S3 transfers.

pub fn set_s3_storage_class(self, input: Option<S3StorageClass>) -> Self

Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.

For buckets in Amazon Web Services Regions, the storage class defaults to STANDARD. For buckets on Outposts, the storage class defaults to OUTPOSTS.

For more information, see Storage class considerations with Amazon S3 transfers.

pub fn get_s3_storage_class(&self) -> &Option<S3StorageClass>

Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.

For buckets in Amazon Web Services Regions, the storage class defaults to STANDARD. For buckets on Outposts, the storage class defaults to OUTPOSTS.

For more information, see Storage class considerations with Amazon S3 transfers.

pub fn s3_config(self, input: S3Config) -> Self

Specifies the Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.

For more information, see Accessing S3 buckets.

pub fn set_s3_config(self, input: Option<S3Config>) -> Self

Specifies the Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.

For more information, see Accessing S3 buckets.

pub fn get_s3_config(&self) -> &Option<S3Config>

Specifies the Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.

For more information, see Accessing S3 buckets.

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

Appends an item to AgentArns.

To override the contents of this collection use set_agent_arns.

(Amazon S3 on Outposts only) Specifies the Amazon Resource Name (ARN) of the DataSync agent on your Outpost.

For more information, see Deploy your DataSync agent on Outposts.

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

(Amazon S3 on Outposts only) Specifies the Amazon Resource Name (ARN) of the DataSync agent on your Outpost.

For more information, see Deploy your DataSync agent on Outposts.

pub fn get_agent_arns(&self) -> &Option<Vec<String>>

(Amazon S3 on Outposts only) Specifies the Amazon Resource Name (ARN) of the DataSync agent on your Outpost.

For more information, see Deploy your DataSync agent on Outposts.

pub fn tags(self, input: TagListEntry) -> Self

Appends an item to Tags.

To override the contents of this collection use set_tags.

Specifies labels that help you categorize, filter, and search for your Amazon Web Services resources. We recommend creating at least a name tag for your transfer location.

pub fn set_tags(self, input: Option<Vec<TagListEntry>>) -> Self

Specifies labels that help you categorize, filter, and search for your Amazon Web Services resources. We recommend creating at least a name tag for your transfer location.

pub fn get_tags(&self) -> &Option<Vec<TagListEntry>>

Specifies labels that help you categorize, filter, and search for your Amazon Web Services resources. We recommend creating at least a name tag for your transfer location.

Trait Implementations

impl Clone for CreateLocationS3FluentBuilder

fn clone(&self) -> CreateLocationS3FluentBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CreateLocationS3FluentBuilder

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

Formats the value using the given formatter.