ListObjectVersions

Prev Next

Classic/VPC環境で利用できます。

Ncloud Storageバケット内オブジェクトのすべてのバージョンのメタデータを照会します。

参考

バージョン管理が設定されたバケットでのみ使用できます。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET -

リクエストヘッダ

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
versions Required Required バージョンのメタデータの照会リクエスト
  • 値なしでキーだけ入力
key-marker String Optional 照会開始の基準 (オブジェクト名)
  • 以前のレスポンス結果のNextKeyMarkerまたは任意の文字列を入力
version-id-marker String Optional 照会開始の基準 (オブジェクトバージョン ID)
  • 以前のレスポンス結果のNextVersionIdMarker
  • 使用時はkey-markerと一緒に入力
max-keys String Optional ページごとの項目数
  • 1~1,000 (デフォルト: 1,000)
prefix String Optional オブジェクト名の接頭辞

リクエスト例

リクエストのサンプルコードは次の通りです。

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

レスポンス

レスポンス形式を説明します。

レスポンスヘッダ

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのレスポンスヘッダをご参照ください。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
ListBucketResult Object - バケットリストの照会結果
ListBucketResult.Name String - バケット名
ListBucketResult.Prefix String - バケット名の接頭辞
  • prefixを入力した場合、入力値を表示
ListBucketResult.NextKeyMarker String - 次の照会基準(オブジェクト名)
  • IsTruncatedがtrueの場合、以降のリクエストのkey-markerにこの値を入力
ListBucketResult.NextVersionIdMarker String - 次の照会基準 (オブジェクトバージョン ID)
  • IsTruncatedがtrueの場合、以降のリクエストのversion-id-markerにこの値を入力
ListBucketResult.MaxKeys Integer - ページごとの項目数
ListBucketResult.IsTruncated Boolean - 以降のページは存在するかどうか
  • true | false
    • true: 存在する
    • false: 存在しない
ListBucketResult.DeleteMarker Array - オブジェクト削除マーカー情報
ListBucketResult.Version Array - オブジェクトバージョンリスト

Version

Versionの説明は次の通りです。

フィールド タイプ 必須の有無 説明
IsLatest Boolean - 最新バージョンかどうか
  • true | false
    • true: 最新バージョン
    • false: 最新バージョンではない
Key String - オブジェクト名
LastModified String - 最終更新日時
  • ISO 8601形式
ETag String - オブジェクトの固有 ID(Entity Tag)
Size Integer - オブジェクトのサイズ(Byte)
StorageClass String - ストレージクラス
  • STANDARD | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
ChecksumAlgorithm String - オブジェクトのチェックサムハッシュアルゴリズム
  • CRC64NVME: CRC-64/NVME
ChecksumType String - オブジェクトのチェックサム計算タイプ
  • COMPOSITE | FULL_OBJECT
    • COMPOSITE: マルチパートのチェックサム
    • FULL_OBJECT: 全オブジェクトのチェックサム
VersionId String - オブジェクトバージョン ID

DeleteMarker

DeleteMarkerの説明は次の通りです。

フィールド タイプ 必須の有無 説明
IsLatest Boolean - 最新バージョンかどうか
  • true | false
    • true: 最新バージョン
    • false: 最新バージョンではない
Key String - オブジェクト名
LastModified String - 作成日時
  • ISO 8601形式
VersionId String - 削除マーカーバージョン ID

レスポンスステータスコード

Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Storageのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

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>