Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Object Storage
  • Terraform reference
    • Authentication with the API
      • How to use the API
      • Signing requests
        • All services and methods
          • All methods
          • create
          • getBucketEncryption
          • getMeta
          • listObjects
          • listBuckets
          • deleteBucket
          • deleteBucketEncryption
          • putBucketEncryption
          • putBucketVersioning
          • getBucketVersioning
          • putBucketLogging
          • getBucketLogging
          • listObjectVersions
          • putObjectLockConfiguration
          • getObjectLockConfiguration
          • putBucketTagging
          • getBucketTagging
          • deleteBucketTagging
        • Common request headers
        • Common response headers
        • Responses
  • Monitoring metrics
  • Audit Trails events
  • Bucket logs
  • Release notes
  • FAQ

In this article:

  • Request
  • Path parameters
  • Headers
  • Response
  • Headers
  • Response codes
  1. API reference
  2. REST (Amazon S3-compatible)
  3. REST
  4. Bucket
  5. create

Create method

Written by
Yandex Cloud
Updated at March 19, 2025
  • Request
    • Path parameters
    • Headers
  • Response
    • Headers
    • Response codes

Creates a bucket.

For more information on getting started with the API and the general request format, see How to use the S3 API.

RequestRequest

PUT /{bucket} HTTP/2

Path parametersPath parameters

Parameter Description
bucket Bucket name.

When creating a bucket, follow the naming conventions.

HeadersHeaders

Use common headers in your requests.

The headers below enable you to set the ACL for 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 in 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 the X-Amz-Grant-* header is a comma-separated list of access grantees. Each access grantee is identified as <access_grantee_type>:<access_grantee_ID>. 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"

ResponseResponse

HeadersHeaders

Responses can only contain common headers.

Response codesResponse codes

For a list of possible responses, see Responses.

A successful response does not contain any additional data.

See alsoSee also

  • Debugging requests using the AWS CLI
  • Example of sending a signed request using curl
  • Code example for generating a signature

Was the article helpful?

Previous
All methods
Next
getBucketEncryption
Yandex project
© 2025 Yandex.Cloud LLC