CreateBucketConfiguration
The configuration information for the bucket.
Contents
- Bucket
-
Specifies the information about the bucket that will be created.
Note
This functionality is only supported by directory buckets.
Type: BucketInfo data type
Required: No
- Location
-
Specifies the location where the bucket will be created.
Directory buckets - The location type is Availability Zone or Local Zone. When the location type is Local Zone, your Local Zone must be in opt-in status. Otherwise, you get an HTTP
400 Bad Request
error with the error codeAccess denied
. To learn more about opt-in Local Zones, see Opt-in Dedicated Local Zonesin the Amazon S3 User Guide.Note
This functionality is only supported by directory buckets.
Type: LocationInfo data type
Required: No
- LocationConstraint
-
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. For more information, see Accessing a bucket in the Amazon S3 User Guide.
If you don't specify a Region, the bucket is created in the US East (N. Virginia) Region (us-east-1) by default.
Note
This functionality is not supported for directory buckets.
Type: String
Valid Values:
af-south-1 | ap-east-1 | ap-northeast-1 | ap-northeast-2 | ap-northeast-3 | ap-south-1 | ap-south-2 | ap-southeast-1 | ap-southeast-2 | ap-southeast-3 | ca-central-1 | cn-north-1 | cn-northwest-1 | EU | eu-central-1 | eu-north-1 | eu-south-1 | eu-south-2 | eu-west-1 | eu-west-2 | eu-west-3 | me-south-1 | sa-east-1 | us-east-2 | us-gov-east-1 | us-gov-west-1 | us-west-1 | us-west-2
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: