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 Общее количество байт, которые хранятся в одной учётной записи Объектного хранилища.