Метод listBuckets
Статья создана
Обновлена 15 августа 2025 г.
Возвращает перечень бакетов, доступных пользователю.
Примечание
Авторизация в Amazon S3 HTTP API и инструментах с его поддержкой осуществляется с помощью статических ключей, полученных для сервисного аккаунта.
Вы можете просматривать список бакетов только в том каталоге, в котором был создан используемый сервисный аккаунт.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
GET / HTTP/2
Заголовки
Используйте в запросе только общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ содержит дополнительные данные в формате XML, схема которого описана ниже.
Схема данных
<ListAllMyBucketsResult>
<Buckets>
<Bucket>
<Name>bucket-name</Name>
<CreationDate>date_time</CreationDate>
</Bucket>
...
</Buckets>
</ListAllMyBucketsResult>
| Элемент | Описание |
|---|---|
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. |