ListObjectVersions

Prev Next

Available in Classic and VPC

Get the metadata of all versions of an object in a Ncloud Storage bucket.

Note

It is only available in a bucket with version control enabled.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET -

Request headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage request headers.

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
versions Required Required Request version metadata query.
  • Enter only keys without values.
key-marker String Optional Query start criteria (object name)
  • The NextKeyMarker value from the previous response result or a random string can be entered.
version-id-marker String Optional Query start criteria (multipart upload ID)
  • NextVersionIdMarker value from the previous response result
  • When using it, it must be entered with key-marker.
max-keys String Optional Number of items per page
  • 1-1000 (default: 1000)
prefix String Optional Object name prefix

Request example

The request example is as follows:

GET /?versions&max-keys=1 HTTP/1.1
Host: bucket.kr.ncloudstorage.com

Response

This section describes the response format.

Response headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage response headers.

Response body

The response body includes the following data:

Field Type Required Description
ListBucketResult Object - Bucket list query result
ListBucketResult.Name String - Bucket name
ListBucketResult.Prefix String - Bucket name prefix
  • Display the input value if prefix is entered.
ListBucketResult.NextKeyMarker String - Next query criteria (object name)
  • If IsTruncated is true, enter that value in key-marker of the next request.
ListBucketResult.NextVersionIdMarker String - Next query criteria (object version ID)
  • If IsTruncated is true, enter that value in version-id-marker of the next request.
ListBucketResult.MaxKeys Integer - Number of items per page
ListBucketResult.IsTruncated Boolean - Whether next page exists
  • true | false
    • true: It exists.
    • false: It doesn't exist.
ListBucketResult.DeleteMarker Array - Object deletion marker information
ListBucketResult.Version Array - Object version list

Version

The following describes Version.

Field Type Required Description
IsLatest Boolean - Whether it is the latest version
  • true | false
    • true: latest version
    • false: not latest version
Key String - Object name
LastModified String - Last modification date and time
  • ISO 8601 format
ETag String - Unique object identifier (entity tag)
Size Integer - Object size (byte)
StorageClass String - Storage class
  • STANDARD | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
ChecksumAlgorithm String - Object checksum hash algorithm
  • CRC64NVME: CRC-64/NVME
ChecksumType String - Object checksum calculation type
  • COMPOSITE | FULL_OBJECT
    • COMPOSITE: multipart checksum
    • FULL_OBJECT: full object checksum
VersionId String - Object version ID

DeleteMarker

The following describes DeleteMarker.

Field Type Required Description
IsLatest Boolean - Whether it is the latest version
  • true | false
    • true: latest version
    • false: not latest version
Key String - Object name
LastModified String - Creation date and time
  • ISO 8601 format
VersionId String - Deletion marker version ID

Response status codes

For information about the HTTP status codes common to all Ncloud Storage APIs, see Common Ncloud Storage response status codes.

Response example

The response example is as follows:

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult>
    <Name>bucket</Name>
    <Prefix></Prefix>
    <MaxKeys>1000</MaxKeys>
    <IsTruncated>false</IsTruncated>
    <DeleteMarker>
        <IsLatest>true</IsLatest>
        <Key>test.xlsx</Key>
        <LastModified>2025-05-19T08:02:12Z</LastModified>
        <VersionId>91f1fe7f-****-****-****-9cc2c468d112</VersionId>
    </DeleteMarker>
    <Version>
        <IsLatest>false</IsLatest>
        <Key>test.xlsx</Key>
        <LastModified>2025-05-19T03:06:04Z</LastModified>
        <ETag>&#34;2dd************************4f6181&#34;</ETag>
        <Size>17423</Size>
        <StorageClass>STANDARD</StorageClass>
        <ChecksumAlgorithm>CRC64NVME</ChecksumAlgorithm>
        <ChecksumType>FULL_OBJECT</ChecksumType>
        <VersionId>null</VersionId>
    </Version>
    <Version>
        <IsLatest>true</IsLatest>
        <Key>object.csv</Key>
        <LastModified>2025-05-19T05:55:33Z</LastModified>
        <ETag>&#34;db7**********************5c35&#34;</ETag>
        <Size>24</Size>
        <StorageClass>STANDARD</StorageClass>
        <ChecksumAlgorithm>CRC64NVME</ChecksumAlgorithm>
        <ChecksumType>FULL_OBJECT</ChecksumType>
        <VersionId>null</VersionId>
    </Version>
    <Version>
        <IsLatest>true</IsLatest>
        <Key>object.jpg</Key>
        <LastModified>2025-05-19T05:56:39Z</LastModified>
        <ETag>&#34;a3f******************************23&#34;</ETag>
        <Size>2799</Size>
        <StorageClass>STANDARD</StorageClass>
        <ChecksumAlgorithm>CRC64NVME</ChecksumAlgorithm>
        <ChecksumType>FULL_OBJECT</ChecksumType>
        <VersionId>null</VersionId>
    </Version>
</ListBucketResult>