Struct CreateBucketConfiguration

#[non_exhaustive]
pub struct CreateBucketConfiguration {
    pub location_constraint: Option<BucketLocationConstraint>,
    pub location: Option<LocationInfo>,
    pub bucket: Option<BucketInfo>,
    pub tags: Option<Vec<Tag>>,
}

The configuration information for the bucket.

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.

location_constraint: Option<BucketLocationConstraint>

Specifies the Region where the bucket will be created. You might choose a Region to optimize latency, minimize costs, or address regulatory requirements. For example, if you reside in Europe, you will probably find it advantageous to create buckets in the Europe (Ireland) Region.

If you don't specify a Region, the bucket is created in the US East (N. Virginia) Region (us-east-1) by default. Configurations using the value EU will create a bucket in eu-west-1.

For a list of the valid values for all of the Amazon Web Services Regions, see Regions and Endpoints.

This functionality is not supported for directory buckets.

location: Option<LocationInfo>

Specifies the location where the bucket will be created.

Directory buckets - The location type is Availability Zone or Local Zone. To use the Local Zone location type, your account must be enabled for Local Zones. Otherwise, you get an HTTP 403 Forbidden error with the error code AccessDenied. To learn more, see Enable accounts for Local Zones in the Amazon S3 User Guide.

This functionality is only supported by directory buckets.

bucket: Option<BucketInfo>

Specifies the information about the bucket that will be created.

This functionality is only supported by directory buckets.

tags: Option<Vec<Tag>>

An array of tags that you can apply to the bucket that you're creating. Tags are key-value pairs of metadata used to categorize and organize your buckets, track costs, and control access.

This parameter is only supported for S3 directory buckets. For more information, see Using tags with directory buckets.

You must have the s3express:TagResource permission to create a directory bucket with tags.

Implementations

impl CreateBucketConfiguration

pub fn location_constraint(&self) -> Option<&BucketLocationConstraint>

Specifies the Region where the bucket will be created. You might choose a Region to optimize latency, minimize costs, or address regulatory requirements. For example, if you reside in Europe, you will probably find it advantageous to create buckets in the Europe (Ireland) Region.

If you don't specify a Region, the bucket is created in the US East (N. Virginia) Region (us-east-1) by default. Configurations using the value EU will create a bucket in eu-west-1.

For a list of the valid values for all of the Amazon Web Services Regions, see Regions and Endpoints.

This functionality is not supported for directory buckets.

pub fn location(&self) -> Option<&LocationInfo>

Specifies the location where the bucket will be created.

Directory buckets - The location type is Availability Zone or Local Zone. To use the Local Zone location type, your account must be enabled for Local Zones. Otherwise, you get an HTTP 403 Forbidden error with the error code AccessDenied. To learn more, see Enable accounts for Local Zones in the Amazon S3 User Guide.

This functionality is only supported by directory buckets.

pub fn bucket(&self) -> Option<&BucketInfo>

Specifies the information about the bucket that will be created.

This functionality is only supported by directory buckets.

pub fn tags(&self) -> &[Tag]

An array of tags that you can apply to the bucket that you're creating. Tags are key-value pairs of metadata used to categorize and organize your buckets, track costs, and control access.

This parameter is only supported for S3 directory buckets. For more information, see Using tags with directory buckets.

You must have the s3express:TagResource permission to create a directory bucket with tags.

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 CreateBucketConfiguration

pub fn builder() -> CreateBucketConfigurationBuilder

Creates a new builder-style object to manufacture CreateBucketConfiguration.

Trait Implementations

impl Clone for CreateBucketConfiguration

fn clone(&self) -> CreateBucketConfiguration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CreateBucketConfiguration

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

Formats the value using the given formatter.

impl PartialEq for CreateBucketConfiguration

fn eq(&self, other: &CreateBucketConfiguration) -> 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 CreateBucketConfiguration