ListObjects

Возвращает часть или весь список в бакете.

В Object Storage поддерживаются две версии метода — ListObject и ListObjectV2. Рекомендуется использовать ListObjectV2 как более новую версию.

Запрос

GET   / { bucket }   HTTP / 2

Path-параметры

Параметр

Описание

bucket

Название бакета.

Query-параметры

Параметр

Описание

delimiter

Символ-разделитель.

encoding-type

Кодировка ответа от сервера. Object Storage по требованию клиента может закодировать ответ в требуемом виде.

key-marker

Ключ, с которого начнется выдача. В выдаче Object Storage оставит ключи, начиная со следующего за key-marker.

max-keys

Максимальное количество элементов в ответе.

prefix

Строка, с которой должен начинаться ключ. Object Storage выберет только те ключи, которые начинаются с prefix.

Заголовки

Список поддерживаемых заголовков приведен в разделе Заголовки запросов.

Пример запроса

Запрос возвращает список объектов в бакете my-bucket.

GET   / my - bucket   HTTP / 2 
 Host :   s3 . cloud . ru 
 Date :   Wed ,   25   Oct   2023   22 : 32 : 00   GMT 
 Authorization :   authorization   string 
 Content - Type :   text / plain

Ответ

Коды ответа

Список возможных ответов собран в разделе Ответы.

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

Пример ответа на запрос.

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Name>my-bucket</Name>
    <Prefix/>
    <Marker/>
    <MaxKeys>1000</MaxKeys>
    <IsTruncated>false</IsTruncated>
    <Contents>
        <Key>my-file.txt</Key>
        <LastModified>2023-10-12T17:50:30.000Z</LastModified>
        <ETag>"fba9dede5f27731c9771645a39863328"</ETag>
        <Size>434234</Size>
        <StorageClass>STANDARD</StorageClass>
        <Owner>
            <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
            <DisplayName>mtd@cloud.ru</DisplayName>
        </Owner>
    </Contents>
    <Contents>
        <Key>my-file-new.txt</Key>
        <LastModified>2023-10-12T17:50:30.000Z</LastModified>
        <ETag>"1b2cf535f27731c974343645a3985328"</ETag>
        <Size>64994</Size>
        <StorageClass>STANDARD_IA</StorageClass>
        <Owner>
            <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
            <DisplayName>mtd@cloud.ru</DisplayName>
        </Owner>
   </Contents>
</ListBucketResult>
См.также
Была ли статья полезной ?
Предыдущая статья
HeadObject
Следующая статья
ListObjectsV2
/ DOCS
Evolution