Struct CreateBucketConfiguration

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

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.

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 Dedicated Local Zones. Otherwise, you get an HTTP 403 Forbidden error with the error code AccessDenied. To learn more, see Enable accounts for Dedicated 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.

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.

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 Dedicated Local Zones. Otherwise, you get an HTTP 403 Forbidden error with the error code AccessDenied. To learn more, see Enable accounts for Dedicated 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.

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 copy 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