Listing Parts in a Multipart Upload

You can list the parts that you already uploaded in one of the sub-parts of your multipart uploads or in a multipart upload of another user. 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.

This feature is not available from Cockpit. This documentation only describes the procedure using 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 SUB_PART \
    --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 of the sub-part.

  • 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.

The list-parts command returns the following elements:

  • 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.

  • Initiator: The initiator of the command, always null.

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

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

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

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

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

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

Result Sample
{
    "Owner": {
        "DisplayName": "ACCOUNT_ID",
        "ID": "USER_ID"
    },
    "Initiator": null,
    "Parts": [
        {
            "LastModified": "2017-02-28T13:52:16.955Z",
            "PartNumber": 1,
            "ETag": "\"c89bc55d61534a407e6ea376e0eedcc0\"",
            "Size": 1048567
        },
        {
            "LastModified": "2017-02-28T13:52:25.315Z",
            "PartNumber": 2,
            "ETag": "\"44c7af3f06fd63a36593826be3cb7684\"",
            "Size": 1048568
        }
    ],
    "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.