Listing the Multipart Uploads of a Bucket

You can list all the multipart uploads for which you have the appropriate permissions for both the bucket and the multipart upload.

This action also returns the upload-id that is a mandatory element for further commands of multipart upload.

Listing the Multipart Uploads of a Bucket Using AWS CLI

Before you begin: Install and configure AWS CLI. For more information, see Installing and Configuring AWS CLI.

To list the multipart uploads of a bucket, use the list-multipart-uploads command following this syntax:

Request sample
$ aws s3api list-multipart-uploads \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --prefix m \
    --delimiter \
    --endpoint https://oos.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

    • bucket: The name of the bucket whose multipart uploads you want to list.

    • (optional) prefix: A letter or a string of characters to filter your objects. It displays the objects that begin with the letter or the characters you specify.

    • (optional) delimiter: A letter to filter your objects. It excludes the objects that begin or contain the letter you specify.

  • endpoint: The endpoint corresponding to the Region you want to send the request to. For more information, see Installing and Configuring AWS CLI.

The list-multipart-uploads command returns the following elements:

  • Uploads: Information about the multipart uploads contained in the bucket. This element contains the following information:

    • Initiator: Information about the user that created the multipart upload. This element contains the following information:

      • DisplayName: The OUTSCALE account ID that made the request with the appropriate permissions.

      • ID: The S3 ID of the user that made the request with the appropriate permissions.

    • Initiated: The date and time at which the multipart upload was created.

    • UploadId: The ID of the upload you received when creating a multipart upload.

    • StorageClass: The storage class of the object, always STANDARD.

    • Key: The name you specified for the multipart upload when creating it.

    • Owner: Information about the owner of the bucket in which the multipart upload was created. This element contains the following information:

      • DisplayName: The OUTSCALE account ID of the owner of the bucket.

      • ID: The S3 user ID of the owner of the bucket.

Result sample
{
    "Uploads": [
        {
            "Initiator": {
                "DisplayName": "ACCOUNT_ID",
                "ID": "USER_ID"
            },
            "Initiated": "2017-04-03T13:37:08.724Z",
            "UploadId": "2~ORJ6aqoheKLu2SoObo-oAmIOBRODgdU",
            "StorageClass": "STANDARD",
            "Key": "MULTIPART_UPLOAD",
            "Owner": {
                "DisplayName": "ACCOUNT_ID",
                "ID": "USER_ID"
            }
        }
    ]
}

Related Page

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.

Export to PDF