Метод listBuckets
Статья создана
Обновлена 15 августа 2025 г.
Возвращает перечень бакетов, доступных пользователю.
Примечание
Авторизация в Amazon S3 HTTP API и инструментах с его поддержкой осуществляется с помощью статических ключей, полученных для сервисного аккаунта.
Вы можете просматривать список бакетов только в том каталоге, в котором был создан используемый сервисный аккаунт.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
GET / HTTP/2
Заголовки
Используйте в запросе только общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ содержит дополнительные данные в формате XML, схема которого описана ниже.
Схема данных
<ListBucketResult
xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<KeyCount>1</KeyCount>
<Name>my-sample-bucket</Name>
<Prefix></Prefix>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>new-prefix/sample-object.txt</Key>
<LastModified>2026-01-14T10:42:41.040Z</LastModified>
<Owner>
<ID>ajeg2b2et02f********</ID>
<DisplayName>ajeg2b2et02f********</DisplayName>
</Owner>
<ETag>"65a8e27d8879283831b664bd********"</ETag>
<Size>13</Size>
<StorageClass>STANDARD</StorageClass>
<TagSet></TagSet>
</Contents>
</ListBucketResult>
| Элемент | Описание |
|---|---|
Bucket |
Содержит описание бакета. Путь: /ListAllMyBucketsResult/Buckets/Bucket. |
Buckets |
Содержит перечень бакетов. Путь: /ListAllMyBucketsResult/Buckets. |
CreationDate |
Время создания бакета в формате yyyy-mm-ddThh:mm:ss.timezone.Путь: /ListAllMyBucketsResult/Buckets/Bucket/CreationDate. |
ListAllMyBucketsResult |
Корневой элемент ответа. Путь: /ListAllMyBucketsResult. |
Name |
Имя бакета. Путь: /ListAllMyBucketsResult/Buckets/Bucket/Name. |