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 :   318 BC8BC148832E5 
 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
См.также
Была ли статья полезной ?
Предыдущая статья
GetBucketPolicyStatus
Следующая статья
PutBucketPolicy
/ DOCS
Evolution