Create Bucket operation

In Amazon S3, objects are organized into buckets, and the Create Bucket operation creates one of these buckets. Each bucket is owned by the Amazon Web Services account (or the AWS account). Each object is identified within each bucket by a unique, user-assigned key. You can create, list, and retrieve buckets and objects using either a Representational State Transfer (REST) HTTP interface or a Simple Object Access Protocol (SOAP) interface.

The following figure shows the <items> XML element for the Create Bucket operation:

<items>
<item>
   <parameters>
     <bucket>TestBucket</bucket>
   </parameters>
</item>
</items>

The following figure shows a sample adapter request for the Create Bucket operation:

<amazon-s3-request>
<secret-access-key />
<operation-name>create-bucket</operation-name>
<parameters>
<bucket>TestBucket</bucket>
</parameters>
</amazon-s3-request>

The following table describes the elements for the adapter request:

Element	Description	Required
<wsdl-location>	Specifies the target WSDL URL for Amazon S3 Example: http://s3.amazonaws.com/doc/2006-03-01/AmazonS3.wsdl	Conditional; required if not specified in the configuration
<endpoint-address>	Specifies the web service endpoint to use for performing operations on Amazon S3 buckets across different regions Default: https://s3.amazonaws.com/soap: Endpoint in the US Standard region Values for regions: https://s3.amazonaws.com/soap: Endpoint in the US Standard region https://s3-us-west-1.amazonaws.com/soap: Endpoint in the US-West (Northern California) region https://s3-eu-west-1.amazonaws.com/soap: Endpoint in the EU (Ireland) region https://s3-ap-southeast-1.amazonaws.com/soap: Endpoint in the Asia Pacific (Singapore) region https://s3-ap-northeast-1.amazonaws.com/soap: Endpoint in the Asia Pacific (Tokyo) region	No
<aws-access-key-id>	Specifies the 20-character public access key ID that is included in an Amazon Web Service (AWS) service request to identify the user	Conditional; required if not specified in the configuration
<secret-access-key>	Specifies the 40-character private identifier that is associated with the access key ID	Conditional; required if not specified in the configuration
<operation-name>	Contains the name of the operation: create-bucket	Yes
<bucket>	Specifies a name for the bucket that you want to create	Yes

The following figure shows a sample adapter response for the Create Bucket operation:

<amazon-s3-response>
<metadata>
<status>success</status>
</metadata>
<CreateBucketResponse>
<BucketName>TestBucket</BucketName>
</CreateBucketResponse>
</amazon-s3-response>

Create Bucket operation

On this page