list-object-versions

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

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

参考

Sub Accountユーザーがこのコマンドを実行するには、View/ListBucketVersionsアクションの権限が必要です。

構文

list-object-versions構文は次の通りです。

aws s3api list-object-versions \
    --bucket <bucket> \
    [--prefix <prefix>] \
    [--starting-token <starting-token>] \
    [--page-size <page-size>] \
    [--max-items <max-items>] \
    --endpoint-url <endpoint-url>

オプション

list-object-versionsの実行時に指定できるオプションについて説明します。

必須オプション

list-object-versionsの必須オプションです。

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名

任意オプション

list-object-versionsの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--prefix`	String	Optional	照会する Prefix
`--starting-token`	String	Optional	照会を開始する位置
`--page-size`	Integer	Optional	ページごとの項目数 `1`~`1000`
`--max-items`	Integer	Optional	出力に含める項目の総数

共通オプション

awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。

例

オブジェクトのバージョン照会リクエストが成功すると、各バージョンの識別情報と最新バージョンであるかどうかが返されます。

コマンド

コマンドの例は次の通りです。

aws s3api list-object-versions --bucket my-test-bucket \
    --endpoint-url=https://kr.ncloudstorage.com

出力

出力の例は次の通りです。

{
    "Versions": [
        {
            "ETag": "\"0625bd26765357783b665dab605fdc7c\"",
            "ChecksumAlgorithm": [
                "CRC32"
            ],
            "ChecksumType": "FULL_OBJECT",
            "Size": 20,
            "StorageClass": "STANDARD",
            "Key": "img/copy.png",
            "VersionId": "11111111-2222-3333-4444-555555555553",
            "IsLatest": true,
            "LastModified": "2026-08-19T02:49:44Z"
        },
        {
            "ETag": "\"0625bd26765357783b665dab605fdc7c\"",
            "ChecksumAlgorithm": [
                "CRC32"
            ],
            "ChecksumType": "FULL_OBJECT",
            "Size": 20,
            "StorageClass": "STANDARD",
            "Key": "img/image.png",
            "VersionId": "11111111-2222-3333-4444-555555555551",
            "IsLatest": true,
            "LastModified": "2026-08-19T02:49:43Z"
        },
        {
            "ETag": "\"0625bd26765357783b665dab605fdc7c\"",
            "ChecksumAlgorithm": [
                "CRC32"
            ],
            "ChecksumType": "FULL_OBJECT",
            "Size": 20,
            "StorageClass": "DEEP_ARCHIVE",
            "Key": "img/image2.png",
            "VersionId": "11111111-2222-3333-4444-555555555552",
            "IsLatest": true,
            "LastModified": "2026-08-19T02:49:44Z"
        },
        {
            "ETag": "\"85641ff9e82a40a643bc74450bc8999f\"",
            "ChecksumAlgorithm": [
                "CRC32"
            ],
            "ChecksumType": "FULL_OBJECT",
            "Size": 48,
            "StorageClass": "STANDARD",
            "Key": "sample.txt",
            "VersionId": "null",
            "IsLatest": true,
            "LastModified": "2026-08-19T02:44:28Z"
        }
    ],
    "RequestCharged": null,
    "Prefix": ""
}