list-parts

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

マルチパートアップロードのパートリストを照会します。

参考

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

構文

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

aws s3api list-parts \
    --bucket <bucket> \
    --key <key> \
    --upload-id <upload-id> \
    [--starting-token <starting-token>] \
    [--page-size <page-size>] \
    [--max-items <max-items>] \
    --endpoint-url <endpoint-url>

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名
`--key`	String	Required	オブジェクト名
`--upload-id`	String	Required	マルチパートアップロード ID create-multipart-uploadを参照

任意オプション

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

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

共通オプション

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

例

パートリストの照会リクエストが成功すると、各パートの識別情報、サイズ、アップロード主体の情報が返されます。

コマンド

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

aws s3api list-parts --bucket my-test-bucket \
    --key large.bin \
    --upload-id {upload_id} \
    --endpoint-url=https://kr.ncloudstorage.com

出力

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

{
    "Parts": [
        {
            "PartNumber": 1,
            "LastModified": "2026-08-19T02:56:40Z",
            "ETag": "\"6d5a86df9e8a0385daf367791d291c94\"",
            "Size": 6291456
        },
        {
            "PartNumber": 2,
            "LastModified": "2026-08-19T02:56:41Z",
            "ETag": "\"f9ef3551facde62260d54299b8c6f24d\"",
            "Size": 6291456
        }
    ],
    "ChecksumAlgorithm": null,
    "Initiator": {
        "ID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "Owner": {
        "ID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "StorageClass": "STANDARD",
    "ChecksumType": null
}