list-multipart-uploads

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

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

構文

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

aws s3api list-multipart-uploads \
    --bucket <bucket> \
    [--delimiter <delimiter>] \
    [--prefix <prefix>] \
    [--starting-token <starting-token>] \
    [--page-size <page-size>] \
    [--max-items <max-items>] \
    --endpoint-url <endpoint-url>

オプション

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

必須オプション

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

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

任意オプション

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

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

共通オプション

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

例

マルチパートアップロードリストの照会リクエストが成功すると、実行中の各アップロードの識別情報と開始日時が返されます。

コマンド

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

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

接頭辞で絞り込んで、一度に照会する件数を制限するコマンドの例は次の通りです。

aws s3api list-multipart-uploads --bucket my-test-bucket \
    --prefix archive/ \
    --max-items 1 \
    --page-size 1 \
    --endpoint-url=https://kr.object.ncloudstorage.com

出力

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

{
    "Uploads": [
        {
            "UploadId": "11111111-2222-3333-4444-555555555551",
            "Key": "t.bin",
            "Initiated": "2026-08-19T07:38:35.215Z",
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "ncp-123456-0",
                "ID": "ncp-123456-0"
            },
            "Initiator": {
                "ID": "ncp-123456-0",
                "DisplayName": "ncp-123456-0"
            }
        }
    ],
    "RequestCharged": null,
    "Prefix": null
}

接頭辞で絞り込んで、照会件数を制限した出力の例は次の通りです。次のページがある場合は、NextTokenが併せて返されます。

{
    "Uploads": [
        {
            "UploadId": "11111111-2222-3333-4444-555555555553",
            "Key": "archive/part-set-a.bin",
            "Initiated": "2026-09-02T06:39:37.427Z",
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "ncp-123456-0",
                "ID": "ncp-123456-0"
            },
            "Initiator": {
                "ID": "ncp-123456-0",
                "DisplayName": "ncp-123456-0"
            }
        }
    ],
    "RequestCharged": null,
    "NextToken": "eyJLZXlNYXJrZXIiOiAiYXJjaGl2ZS9wYXJ0LXNldC1hLmJpbiIsICJVcGxvYWRJZE1hcmtlciI6ICIxMTExMTExMS0yMjIyLTMzMzMtNDQ0NC01NTU1NTU1NTU1NTMifQ=="
}