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 |
Символ-разделитель. |
encoding-type |
Кодировка ответа от сервера. Object Storage по требованию клиента может закодировать ответ в требуемом виде. |
key-marker |
Ключ, с которого начнется выдача. В выдаче Object Storage оставит ключи, начиная со следующего за key-marker. |
max-keys |
Максимальное количество элементов в ответе. |
prefix |
Строка, с которой должен начинаться ключ. Object Storage выберет только те ключи, которые начинаются с prefix. |
version-id-marker |
Версия объекта, с которой начинается выдача. В выдаче Object Storage оставит версии, начиная со следующей за version-id-marker. |
Заголовки
Список поддерживаемых заголовков приведен в разделе Заголовки запросов.
Пример запроса
Запрос возвращает список версий всех объектов в бакете my-bucket.
GET /my-bucket?versions HTTP/2Host: s3.cloud.ruDate: Wed, 25 Oct 2023 22:32:00 GMTAuthorization: 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>
- Запрос
- Ответ