Object Storage API, REST совместимый с Amazon S3: ListObjectVersions
Возвращает метаданные обо всех версиях объектов в бакете.
Также можно использовать параметры запроса в качестве критерия выбора для возврата метаданных о подмножестве версий объекта.
Подробнее о подготовке к работе с API и общем виде запроса в разделе Как пользоваться S3 API.
Запрос
GET /{bucket}?versions&delimiter=Delimiter&encoding-type=EncodingType&key-marker=KeyMarker&max-keys=MaxKeys&prefix=Prefix&version-id-marker=VersionIdMarker HTTP/2
Path параметры
|
Параметр |
Описание |
|
|
Имя бакета |
Query параметры
Все перечисленные в таблице параметры необязательные.
|
Параметр |
Описание |
|
|
Символ-разделитель. Если параметр указан, то Object Storage рассматривает ключ как путь к файлу, где каталоги разделяются символом Если в запросе указан еще и параметр |
|
|
Кодировка ответа от сервера. Object Storage по требованию клиента может закодировать ответ в требуемом виде. Возможные значения: |
|
|
Ключ, с которого начнется выдача. В результирующей выдаче Object Storage оставит ключи, начиная со следующего за |
|
|
Максимальное количество элементов в ответе. По умолчанию Object Storage выдает не более 1000 элементов Если под критерии отбора попадает больше ключей, чем поместилось в выдаче, то ответ содержит Чтобы получить все элементы выдачи, если их больше |
|
|
Строка, с которой должен начинаться ключ. Object Storage выберет только те ключи, которые начинаются с Может использоваться одновременно с параметром |
|
|
Версия объекта, с которой начинается выдача. В результирующей выдаче Object Storage оставит версии, начиная со следующей за |
Заголовки
Используйте в запросе только общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ содержит дополнительные данные в формате XML, схема которого описана ниже.
Схема данных
<?xml version="1.0" encoding="UTF-8"?>
<ListVersionsResult>
<IsTruncated>boolean</IsTruncated>
<KeyMarker>string</KeyMarker>
<VersionIdMarker>string</VersionIdMarker>
<NextKeyMarker>string</NextKeyMarker>
<NextVersionIdMarker>string</NextVersionIdMarker>
<Version>
<ETag>string</ETag>
<IsLatest>boolean</IsLatest>
<Key>string</Key>
<LastModified>timestamp</LastModified>
<Owner>
<DisplayName>string</DisplayName>
<ID>string</ID>
</Owner>
<Size>integer</Size>
<StorageClass>string</StorageClass>
<VersionId>string</VersionId>
</Version>
...
<DeleteMarker>
<IsLatest>boolean</IsLatest>
<Key>string</Key>
<LastModified>timestamp</LastModified>
<Owner>
<DisplayName>string</DisplayName>
<ID>string</ID>
</Owner>
<VersionId>string</VersionId>
</DeleteMarker>
...
<Name>string</Name>
<Prefix>string</Prefix>
<Delimiter>string</Delimiter>
<MaxKeys>integer</MaxKeys>
<CommonPrefixes>
<Prefix>string</Prefix>
</CommonPrefixes>
...
<EncodingType>string</EncodingType>
</ListVersionsResult>
|
Элемент |
Описание |
|
|
Корневой элемент. |
|
|
Часть имени ключа, которая определяется при обработке query параметров Путь: |
|
|
Контейнер для объекта, который является маркером удаления. Путь: |
|
|
Значение query параметра Путь: |
|
|
Кодировка, в которой Object Storage представляет ключ в XML-ответе. Появляется, если клиент при запросе передал параметр Путь: |
|
|
Признак неполноты списка. Если Путь: |
|
|
Последний ключ, возвращенный в неполном ответе. Путь: |
|
|
Значение query параметра Путь: |
|
|
Название бакета. Путь: |
|
|
Значение, которое надо подставить в query параметр Путь: |
|
|
Значение, которое надо подставить в query параметр Путь: |
|
|
Значение query параметра Путь: |
|
|
Версия объекта. Путь: |
|
|
Отмечает последнюю версию ключа, возвращенную в усеченном ответе. Путь: |