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
          • XML structure of ACL configuration
          • objectGetAcl
          • objectPutAcl
          • bucketGetAcl
          • bucketPutAcl
        • Common request headers
        • Common response headers
        • Responses
  • Monitoring metrics
  • Audit Trails events
  • Bucket logs
  • Release notes
  • FAQ

In this article:

  • Request
  • Path parameters
  • Request parameters
  • Headers
  • Data schema
  • Response
  • Headers
  • Response codes
  1. API reference
  2. REST (Amazon S3-compatible)
  3. REST
  4. ACL
  5. bucketPutAcl

bucketPutAcl method

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

Uploads an access control list for a bucket.

Note

You can upload an ACL as an XML document or using special X-Amz-Grant* headers. Do not use an XML document and X-Amz-Grant* headers in the same request.

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

RequestRequest

PUT /{bucket}?acl HTTP/2

Path parametersPath parameters

Parameter Description
bucket Bucket name.

Request parametersRequest parameters

Parameter Description
acl Required parameter that indicates the type of operation.

HeadersHeaders

Use the appropriate common headers in your request.

You can also use the headers listed below.

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"

Data schemaData schema

ACLs are provided as XML documents. For the schema description, see ACL XML schema.

ResponseResponse

HeadersHeaders

Responses can only contain common headers.

Response codesResponse codes

For a list of possible responses, see Responses.

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
bucketGetAcl
Next
All methods
Yandex project
© 2025 Yandex.Cloud LLC