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 a bucket to be created by using the headers listed below.

Heading Description
x-amz-acl Sets a predefined ACL for an object.
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 heading with x-amz-grant-read, otherwise Object Storage will return 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 a 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 — Yandex.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.