---
title: "ListObjectVersions"
slug: "ncloudstorage-listobjectversions"
updated: 2026-09-17T09:58:30Z
published: 2026-09-17T09:58:30Z
canonical: "api.ncloud-docs.com/ncloudstorage-listobjectversions"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ListObjectVersions

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

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

              参考

              

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

## リクエスト

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

| メソッド | URI |
| --- | --- |
| GET | - |

### リクエストヘッダ

Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのリクエストヘッダ](/docs/ja/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `versions` | String | 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のレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。

### レスポンスボディ

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `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 | - | [オブジェクト削除マーカー情報](/docs/ja/ncloudstorage-listobjectversions#DeleteMarker) |
| `ListBucketResult.Version` | Array | - | [オブジェクトバージョンリスト](/docs/ja/ncloudstorage-listobjectversions#Version) |

#### `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のレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

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

```
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>"2dd************************4f6181"</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>"db7**********************5c35"</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>"a3f******************************23"</ETag>
        <Size>2799</Size>
        <StorageClass>STANDARD</StorageClass>
        <ChecksumAlgorithm>CRC64NVME</ChecksumAlgorithm>
        <ChecksumType>FULL_OBJECT</ChecksumType>
        <VersionId>null</VersionId>
    </Version>
</ListBucketResult>
```