Метод listObjectVersions
Статья создана
Возвращает метаданные обо всех версиях объектов в бакете.
Также можно использовать параметры запроса в качестве критерия выбора для возврата метаданных о подмножестве версий объекта.
Запрос
GET /{bucket}?versions&delimiter=Delimiter&encoding-type=EncodingType&key-marker=KeyMarker&max-keys=MaxKeys&prefix=Prefix&version-id-marker=VersionIdMarker HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
Query параметры
Все перечисленные в таблице параметры необязательные.
| Параметр | Описание |
|---|---|
delimiter |
Символ-разделитель. Если параметр указан, то Object Storage рассматривает ключ как путь к файлу, где каталоги разделяются символом delimiter. В ответе на запрос пользователь увидит перечень файлови каталоговв бакете. Файлыбудут выведены в элементах Contents, а каталогив элементах CommonPrefixes.Если в запросе указан еще и параметр prefix, то Object Storage вернет перечень файлови каталоговв каталоге prefix. |
encoding-type |
Кодировка ответа от сервера. Object Storage по требованию клиента может закодировать ответ в требуемом виде. Возможные значения: url |
key-marker |
Ключ, с которого начнется выдача. В результирующей выдаче Object Storage оставит ключи, начиная со следующего за key-marker. |
max-keys |
Максимальное количество элементов в ответе. По умолчанию Object Storage выдает не более 1000 элементов Contents и CommonPrefixes. Параметр следует использовать, если вам нужно получать менее 1000 элементов в одном ответе.Если под критерии отбора попадает больше ключей, чем поместилось в выдаче, то ответ содержит <IsTruncated>true</IsTruncated>.Чтобы получить все элементы выдачи, если их больше max-keys, необходимо выполнить несколько последовательных запросов к Object Storage с параметром key-marker, где для каждого запроса key-marker и version-id-marker равны значениям элементов NextKeyMarker и NextVersionIdMarker из предыдущего ответа. |
prefix |
Строка, с которой должен начинаться ключ. Object Storage выберет только те ключи, которые начинаются с prefix.Может использоваться одновременно с параметром delimiter. В этом случае логика выдачи становится той, что указана в описании параметра delimiter. |
version-id-marker |
Версия объекта, с которой начинается выдача. В результирующей выдаче Object Storage оставит версии, начиная со следующей за version-id-marker. |
Заголовки
Используйте в запросе только общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ содержит дополнительные данные в формате 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>
| Элемент | Описание |
|---|---|
ListVersionsResult |
Корневой элемент |
CommonPrefixes |
Часть имени ключа, которая определяется при обработке query параметров delimiter и prefix.Путь: /ListVersionsResult/CommonPrefixes. |
DeleteMarker |
Контейнер для объекта, который является маркером удаления. Путь: /ListVersionsResult/DeleteMarker. |
Delimiter |
Значение query параметра delimiter.Путь: /ListVersionsResult/Delimiter. |
EncodingType |
Кодировка, в которой Object Storage представляет ключ в XML-ответе. Появляется, если клиент при запросе передал параметр encoding-type.Путь: /ListVersionsResult/EncodingType. |
IsTruncated |
Признак неполноты списка. Если IsTruncated — true, то это означает, что Object Storage вернул не полный список частей.Путь: /ListVersionsResult/IsTruncated. |
KeyMarker |
Последний ключ, возвращенный в неполном ответе. Путь: /ListVersionsResult/KeyMarker. |
MaxKeys |
Значение query параметра max-keys.Путь: /ListBucketResult/MaxKeys. |
Name |
Название бакета. Путь: /ListBucketResult/Name. |
NextKeyMarker |
Значение, которое надо подставить в query параметр key-marker для получения следующей части списка, если весь список не поместился в текущий ответ.Путь: /ListBucketResult/NextMarker. |
NextVersionIdMarker |
Значение, которое надо подставить в query параметр version-id-marker для получения следующей части списка, если весь список не поместился в текущий ответ.Путь: /ListBucketResult/NextVersionIdMarker. |
Prefix |
Значение query параметра prefix.Путь: /ListBucketResult/Prefix. |
Version |
Версия объекта. Путь: /ListBucketResult/Version. |
VersionIdMarker |
Отмечает последнюю версию ключа, возвращенную в усеченном ответе. Путь: /ListBucketResult/VersionIdMarker. |