Class: Aws::S3::Types::CreateBucketConfiguration

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-s3/types.rb

Overview

The configuration information for the bucket.

See Also:

Constant Summary collapse

SENSITIVE = 
[]

Instance Attribute Summary collapse

Instance Attribute Details

#bucket ⇒ Types::BucketInfo

Specifies the information about the bucket that will be created.

<note markdown=“1”> This functionality is only supported by directory buckets.

</note>

Returns:



2717
2718
2719
2720
2721
2722
2723
2724
 
# File 'lib/aws-sdk-s3/types.rb', line 2717

class CreateBucketConfiguration < Struct.new(
  :location_constraint,
  :location,
  :bucket,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#location ⇒ Types::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*.

<note markdown=“1”> This functionality is only supported by directory buckets.

</note>

[1]: docs.aws.amazon.com/AmazonS3/latest/userguide/opt-in-directory-bucket-lz.html

Returns:



2717
2718
2719
2720
2721
2722
2723
2724
 
# File 'lib/aws-sdk-s3/types.rb', line 2717

class CreateBucketConfiguration < Struct.new(
  :location_constraint,
  :location,
  :bucket,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#location_constraint ⇒ String

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].

<note markdown=“1”> This functionality is not supported for directory buckets.

</note>

[1]: docs.aws.amazon.com/general/latest/gr/rande.html#s3_region

Returns:

  • (String) 


2717
2718
2719
2720
2721
2722
2723
2724
 
# File 'lib/aws-sdk-s3/types.rb', line 2717

class CreateBucketConfiguration < Struct.new(
  :location_constraint,
  :location,
  :bucket,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ Array<Types::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.

<note markdown=“1”> This parameter is only supported for S3 directory buckets. For more information, see [Using tags with directory buckets].

</note>

[1]: docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html

Returns:



2717
2718
2719
2720
2721
2722
2723
2724
 
# File 'lib/aws-sdk-s3/types.rb', line 2717

class CreateBucketConfiguration < Struct.new(
  :location_constraint,
  :location,
  :bucket,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end