PutBucketAcl

Устанавливает ACL для бакета. Если ACL был задан ранее, метод заменяет его на новый.

Запрос

PUT /{bucket}?acl HTTP/2

Path-параметры

Параметр

Описание

bucket

Название бакета.

Query-параметры

Параметр

Описание

acl

Обязательный параметр для обозначения типа операции.

Заголовки

Список поддерживаемых заголовков приведен в разделе Заголовки запросов.

Пример запроса

Запрос предоставляет разрешение на доступ к существующему объекту my-file.txt. В теле запроса указывается ACL.

  PUT /my-bucket?acl HTTP/2
  Host: s3.cloud.ru
  Content-Length: 1660
  Date: Wed, 25 Oct 2023 22:32:00 GMT
  Authorization: authorization string

  <AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Owner>
      <ID>852b113e7a2f25102679df27bb0ae12b3f85be6BucketOwnerCanonicalUserID</ID>
      <DisplayName>OwnerDisplayName</DisplayName>
    </Owner>
    <AccessControlList>
      <Grant>
        <Grantee xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" _XMLSchema-instance:type="CanonicalUser">
          <ID>852b113e7a2f25102679df27bb0ae12b3f85be6BucketOwnerCanonicalUserID</ID>
          <DisplayName>OwnerDisplayName</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
    <Grant>
      <Grantee xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" _XMLSchema-instance:type="Group">
        <URI xmlns="">http://acs.amazonaws.com/groups/global/AllUsers</URI>
      </Grantee>
      <Permission xmlns="">READ</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

Ответ

Коды ответа

Список возможных ответов собран в разделе Ответы.

Пример ответа

Пример ответа при включении версионности для бакета my-bucket.

HTTP/2 200 OK
x-amz-request-id: 318BC8BC148832E5
x-amz-version-id: 3/L4kqtJlcpXrof3vjVBH40Nr8X8gdRQBpUMLUo
Date: Wed, 25 Oct 2023 22:32:00 GMT
Last-Modified: Sun, 1 Oct 2023 12:00:00 GMT
Content-Length: 0
Connection: close
Server: s3.cloud.ru

См.также

Запустили Evolution free tier
для Dev & Test
Получить