Skip to main content

Получение информации об объектах S3

Запрос возвращает метаданные с информацией о количестве и объеме хранения контейнеров и объектов.

Отправка адреса URL для авторизации в хранилище:

export publicURL="https://api-ru-moscow-vol5.a2-cloud.ru:6780/swift/v3/AUTH_id_your_project"

Метод GET

curl $publicURL?format=json -X GET -H "X-Auth-Token: $TOKEN"

Чтобы получить дополнительную информацию о контейнерах (размер, дату обновления и т. д.), используйте query-параметр ?format=json.

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

{
"name": "marktwain",
"count": 1,
"bytes": 5
},
{
"name": "marktwain1",
"count": 0,
"bytes": 0
},
{
"name": "steven",
"count": 0,
"bytes": 0
},
{
"name": "test",
"count": 2,
"bytes": 73748
}
]

Коды ответов:

  • успешно -- 200 (получен список контейнеров)

  • с ошибкой -- 204

Параметры запроса

Параметр Тип Формат Описание
format (опционально) string query Формат ответа. Допустимые значения:
json
xml
plain

Значение по умолчанию — plain. При добавлении format=xml или format=json к URL-адресу учётной записи хранилища, в ответе будет отображена расширенная информация о контейнере в указанном формате. Если указано format=plain, в ответе будут перечислены названия контейнеров.
X-Auth-Token (опционально) string header Токен аутентификации. Если не указать этот заголовок, запрос будет отклонён.

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

Параметр Тип Формат Описание
name string body Название контейнера
count integer body Количество объектов в контейнере
bytes integer body Общее количество байт, которые хранятся в одной учётной записи Объектного хранилища.