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