create method
Creates a bucket.
Request
PUT /{bucket} HTTP/1.1
Path parameters
| Parameter | Description |
|---|---|
bucket |
Bucket name. When creating a bucket, follow the bucket naming guidelines. |
Headers
Use common request headers in requests.
By using the headers listed below, you can set the ACL of the bucket being created.
| Header | Description |
|---|---|
x-amz-acl |
Sets permissions types for a bucket. |
x-amz-grant-read |
Grants the access grantee permission to view the contents of a bucket and read objects within it. |
x-amz-grant-write |
Grants the access grantee object write permission. You must use this header with x-amz-grant-read, otherwise Object Storage returns the code 501 Not Implemented. |
x-amz-grant-read-acp |
Grants the access grantee bucket ACL read permission. |
x-amz-grant-write-acp |
Grants the access grantee bucket ACL write permission. |
x-amz-grant-full-control |
Grants the access grantee the following permissions: READ, WRITE, READ_ACP, and WRITE_ACP for a bucket. |
The value for an x-amz-grant-* header is a comma-separated list of access grantees. Each access grantee is identified in a structure like <access grantee type>:<access grantee ID>. Object Storage supports the following types of access grantees:
id— access grantee — cloud user.uri— access grantee — system group.
Example:
x-amz-grant-read: uri="http://acs.amazonaws.com/groups/s3/AuthenticatedUsers"
Response
Headers
Responses can only contain common response headers.
Response codes
For a list of possible responses, see Responses.
A successful response does not contain any additional data.