Create method
Written by
Updated at September 30, 2024
Creates a bucket.
For more information on getting started with the API and the general request format, see How to use the S3 API.
Request
PUT /{bucket} HTTP/2
Path parameters
Parameter | Description |
---|---|
bucket |
Bucket name. When creating a bucket, follow the naming conventions. |
Headers
Use common request headers in your requests.
By using the headers listed below, you can set the ACL of the bucket being created.
Header | Description |
---|---|
X-Amz-Acl |
Sets permission 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. Make sure to use this header with X-Amz-Grant-Read ; otherwise, Object Storage will return the 501 Not Implemented code. |
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 READ , WRITE , READ_ACP , and WRITE_ACP permissions for the bucket. |
The value for an X-Amz-Grant-*
header is a comma-separated list of access grantees. Each access grantee is identified in a <access_grantee_type>:<access_grantee_ID>
sctructure. Object Storage supports the following types of access grantees:
id
: Access grantee is a cloud user.uri
: Access grantee is a public 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.