PUT Bucket

Creates a bucket and sets the user issuing the request as the bucket owner. Buckets cannot be created by anonymous users.

Request syntax

PUT / HTTP/1.1
Host: BucketName.rs2.StorageService.com
Content-Length: length
Date: date
Authorization: signatureValue

Request headers

The PUT Bucket operation accepts the following request headers:
Authorization, Content-Length, Content-Type, Date, Host, and x-amz-acl. Use the x-amz-acl request header to configure the bucket access control settings.

The Authorization, Date, and Host headers are required; the others are optional. For more information, see Request Headers.

Response headers

The PUT Bucket acl operation may include the following response headers: Content-Length, Connection, Date, ETag, and Server.
 
For more information, see Response Headers.

Examples

Request sample

This sample creates a bucket named "documentation".

PUT / HTTP/1.1
Host: documentation.demo.cloud.it
Date: Thu, 16 Jun 2011 15:30:07 GMT
Authorization: AWS pat:fxA/7CeKyl3QJewhIguziTMp8Cc=
Response sample
HTTP/1.1 200 OK
Date: Thu, 16 Jun 2011 15:30:07 GMT
Server: RestServer/1.0
Content-Length: 0
Content-Type: application/octet-stream
Connection: close