- tocdepth
2
ListObjectVersions
Возвращает список версий всех объектов в бакете.
Запрос
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 оставит версии, начиная со следующей за |
Заголовки
Список поддерживаемых заголовков приведен в разделе Заголовки запросов.
Пример запроса
Запрос возвращает список версий всех объектов в бакете my-bucket
.
GET /my-bucket?versions HTTP/2
Host: s3.cloud.ru
Date: Wed, 25 Oct 2023 22:32:00 GMT
Authorization: authorization string
Ответ
Коды ответа
Список возможных ответов собран в разделе Ответы.
Пример ответа
Пример ответа на запрос.
<?xml version="1.0" encoding="UTF-8"?>
<ListVersionsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
<Name>my-bucket</Name>
<Prefix>my</Prefix>
<KeyMarker/>
<VersionIdMarker/>
<MaxKeys>5</MaxKeys>
<IsTruncated>false</IsTruncated>
<Version>
<Key>my-file.txt</Key>
<VersionId>3/L4kqtJl40Nr8X8gdRQBpUMLUo</VersionId>
<IsLatest>true</IsLatest>
<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>
</Version>
<DeleteMarker>
<Key>my-file-new.txt</Key>
<VersionId>03jpff543dhffds434rfdsFDN943fdsFkdmqnh892</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2023-11-12T17:50:30.000Z</LastModified>
<Owner>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>mtd@cloud.ru</DisplayName>
</Owner>
</DeleteMarker>
<Version>
<Key>my-file-new.txt</Key>
<VersionId>QUpfdndhfd8438MNFDN93jdnJFkdmqnh893</VersionId>
<IsLatest>false</IsLatest>
<LastModified>2023-10-10T17:50:30.000Z</LastModified>
<ETag>"9b2cf535f27731c974343645a3985328"</ETag>
<Size>166434</Size>
<StorageClass>STANDARD</StorageClass>
<Owner>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>mtd@cloud.ru</DisplayName>
</Owner>
</Version>
</ListVersionsResult>
См.также
Была ли статья полезной?
для Dev & Test