|« PreviousNext »|
|Did this page help you? Yes | No | Tell us about it...|
CreateBucket operation creates a bucket. Not every string is an acceptable bucket name.
For information on bucket naming restrictions, see Working with Amazon S3 Buckets
To determine whether a bucket name exists, use
ListBucket and set
MaxKeys to 0.
A NoSuchBucket response indicates that the bucket is available, an AccessDenied response indicates that someone else owns the bucket, and a Success response indicates that you own the bucket or have permission to access it.
Example Create a bucket named "quotes".
<CreateBucket xmlns="http://doc.s3.amazonaws.com/2006-03-01"> <Bucket>quotes</Bucket> <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId> <Timestamp>2006-03-01T12:00:00.183Z</Timestamp> <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature> </CreateBucket>
<CreateBucketResponse xmlns="http://s3.amazonaws.com/doc/2006-03-01"> <CreateBucketResponse> <Bucket>quotes</Bucket> </CreateBucketResponse> </CreateBucketResponse>
Bucket: The name of the bucket you are trying to create.
AccessControlList: The access control list for the new bucket.
This element is optional. If not provided, the bucket is created with an access policy
that give the requester FULL_CONTROL access.
You must authenticate with a valid AWS Access Key ID. Anonymous requests are never allowed to create buckets.