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/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>

См.также

ListObjectVersions

Была ли статья полезной?