Listing Parts in a Multipart Upload

You can list the parts that you already uploaded in a multipart upload. To do so, you need to have the appropriate permissions for both the bucket and the multipart upload.

The parts that other users uploaded to one of your multipart uploads are also returned.

This action also returns information about the date and time at which you started the upload of an object.

Listing Parts in a Multipart Upload Using AWS CLI

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

To list the uploaded parts in the bucket, use the list-parts command following this syntax:

Request sample
$ aws s3api list-parts \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key MULTIPART_UPLOAD \
    --upload-id 2~xrosnH8pbKTk3sjXijfGIUN1KAEM3Yc \
    --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 bucket in which you created the multipart upload.

  • key: The name given to the multipart upload.

  • upload-id: The ID of the upload you received when creating a multipart upload. For more information, see Creating a Multipart Upload.

  • 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-parts command returns the following elements:

  • Parts: Information about the parts you uploaded. This element contains the following information:

    • PartNumber: The part number of the upload you specified.

    • LastModified: The date and time at which the object was last modified.

    • ETag: The ETag of the upload of the object.

    • Size: The size of the object, in bytes.

  • ChecksumAlgorithm: Specifies the algorithm used to calculate the checksum of the parts (always null).

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

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

    • DisplayName: The OUTSCALE account ID of the user that uploaded the part.

  • Owner: Information about the owner of the uploaded part. This element contains the following information:

    • DisplayName: The OUTSCALE account ID of the user that uploaded the part.

    • ID: The S3 user ID of the owner of the uploaded part.

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

Result Sample
{
    "Parts": [
        {
            "PartNumber": 1,
            "LastModified": "2017-02-28T13:52:16.955Z",
            "ETag": "\"c89bc55d61534a407e6ea376e0eedcc0\"",
            "Size": 1048567
        },
        {
            "PartNumber": 2,
            "LastModified": "2017-02-28T13:52:25.315Z",
            "ETag": "\"44c7af3f06fd63a36593826be3cb7684\"",
            "Size": 1048568
        }
    ],
    "ChecksumAlgorithm": null,
    "Initiator": {
        "ID": "USER_ID",
        "DisplayName": "ACCOUNT_ID"
    },
    "Owner": {
        "DisplayName": "ACCOUNT_ID",
        "ID": "USER_ID"
    },
    "StorageClass": "STANDARD"
}

Related Pages

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