2.38 ListBuckets

Возвращает список всех бакетов, принадлежащих авторизованному отправителю запроса.
Наряду со стандартными заголовками, система поддерживает специфичные для данной операции параметры, перечисленные ниже.
Подробную информацию об операции и примеры см. в документации AWS: ListBuckets

Предыдущее название операции: GET Service

Параметры запроса (Query Parameters)

Система поддерживает следующий опциональный параметр запроса в качестве расширения операции "ListBuckets".

shared

Если в запросе указан параметр shared, операция ListBuckets возвращает список бакетов, которыми другие пользователи поделились с запрашивающим пользователем. Это будут бакеты, которыми поделились непосредственно с запрашивающим пользователем, бакеты, которыми поделились с группой, к которой принадлежит запрашивающий пользователь, и бакеты, которыми поделились со всеми.

Пример

GET /?shared HTTP/1.1.
Host: s3-region1.enterprise4.mobi-cloud.com.
Accept-Encoding: identity.
Date: Fri, 05 Apr 2019 15:34:01 GMT.
Content-Length: 0.
Authorization: AWS akey2:jTcwd1Ta+5sZftVHGtEEyweojdk=.
User-Agent: Boto/2.42.0 Python/2.7.5 Linux/3.10.0-693.el7.x86_64.



HTTP/1.1 200 OK.
Date: Fri, 05 Apr 2019 15:34:01 GMT.
x-amz-request-id: 1721b414-267b-1341-93e6-d4ae52ce5402.
Content-Type: application/xml;charset=UTF-8.
Content-Length: 432.
Server: CloudianS3.


<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResultxmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Owner>
      <ID>8ce1c49e532edc91b0a43e0c7e7d5975</ID>
      <DisplayName>
             robot1
      </DisplayName>
</Owner>
<Buckets>
      <Bucket>
           <Name>
                 sharedbucket1
           </Name>
           <CreationDate>
                 2019-04-05T15:30:03.897Z
           </CreationDate>
      </Bucket>
      <Bucket>
           <Name>
                sharedbucket2
          </Name>
          <CreationDate>
                2019-04-05T15:27:26.300Z
          </CreationDate>
    </Bucket>
</Buckets>
</ListAllMyBucketsResult>

Примечание. При использовании параметра 'shared' вызов ListBuckets возвращает только те бакеты, которые были предоставлены запрашивающему пользователю, а не те, которые ему принадлежат. Таким образом, чтобы получить все бакеты, к которым пользователь имеет доступ, клиентское приложение S3 должно отправить два вызова ListBuckets: один без параметра 'shared' (для получения собственных бакетов пользователя) и один с параметром 'shared' (для получения бакетов, которые были ему предоставлены).

Примечание. При использовании параметра 'shared' в теле ответа ListBuckets в поле "Owner" указывается пользователь, отправивший запрос, а не фактический владелец общего бакета.

см. также:

к S3 API