Struct CreateLocationS3Input

#[non_exhaustive]
pub struct CreateLocationS3Input {
    pub subdirectory: Option<String>,
    pub s3_bucket_arn: Option<String>,
    pub s3_storage_class: Option<S3StorageClass>,
    pub s3_config: Option<S3Config>,
    pub agent_arns: Option<Vec<String>>,
    pub tags: Option<Vec<TagListEntry>>,
}

CreateLocationS3Request

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

subdirectory: 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

s3_bucket_arn: 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.

s3_storage_class: 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.

s3_config: 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 Providing DataSync access to S3 buckets.

agent_arns: 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.

tags: 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.

Implementations

impl CreateLocationS3Input

pub fn subdirectory(&self) -> Option<&str>

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) -> Option<&str>

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) -> 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) -> 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 Providing DataSync access to S3 buckets.

pub fn agent_arns(&self) -> &[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.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .agent_arns.is_none().

pub fn tags(&self) -> &[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.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .tags.is_none().

impl CreateLocationS3Input

pub fn builder() -> CreateLocationS3InputBuilder

Creates a new builder-style object to manufacture CreateLocationS3Input.

Trait Implementations

impl Clone for CreateLocationS3Input

fn clone(&self) -> CreateLocationS3Input

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CreateLocationS3Input

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

Formats the value using the given formatter.

impl PartialEq for CreateLocationS3Input

fn eq(&self, other: &CreateLocationS3Input) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CreateLocationS3Input