Lists the uploaded parts for an ongoing
XML API multipart upload
, returned
in an XML document in the response body.
Parts in the list are ordered sequentially, and the XML API does not return
lists longer than 1000 parts. If there are more parts to return than can fit
in the response, the response returns an
IsTruncated
element with a value of
true
and a
NextPartNumberMarker
element which you can use in subsequent
listing requests.
Query string parameters
Parameter
|
Description
|
Required
|
max-parts
|
The maximum number of parts to return in the response.
|
No
|
part-number-marker
|
The part number that you want the listing to begin after. Parts whose
numbers are greater than the
part-number-marker
are returned
in the list of parts.
|
No
|
uploadId
|
The multipart upload for which you want to list the parts.
|
Yes
|
See
signed URL query string parameters
for information on the parameters
you include when creating and using
signed URLs
.
See
common request headers
.
Request body elements
This request does not include an XML document in the request body.
Request syntax
The following syntax applies to GET Object requests that use the
uploadId
query string parameter.
GET /
OBJECT_NAME
?uploadId=
UPLOAD_ID
&max-parts=
MAX_NUM_PARTS
&part-number-marker=
PART_NUMBER
HTTP/1.1
Host:
BUCKET_NAME
.storage.googleapis.com
Date:
DATE
Content-Length: 0
Authorization:
AUTHENTICATION_STRING
The request can return a variety of response headers depending on the request
headers you use.
Response body elements
The following response body elements apply to GET Object requests that use the
uploadId
query string parameter.
Element
|
Description
|
ListPartsResult
|
Container for the part information you are requesting.
|
Bucket
|
The name of the bucket that contains the requested multipart upload.
|
Key
|
The name of the object the multipart upload was initiated for.
|
UploadId
|
The upload ID of the requested multipart upload.
|
StorageClass
|
The storage class that parts in the multipart upload are stored as.
|
PartNumberMarker
|
The part number after which the current listing begins.
|
NextPartNumberMarker
|
The number of the last part returned in this listing. This is included
in the response only if the list is truncated. Use this value in the
part-number-marker
query string parameter of a future
listing request in order to list the parts that follow the current set
of results.
|
MaxParts
|
The maximum number of parts that were allowed in the response, as given
by
max-parts
in the request or 1000, whichever is
smaller.
|
IsTruncated
|
Indicates whether or not there are parts for the upload that do not
appear in the current results due to the response containing a maximum
number of parts.
|
Part
|
A container for each part of the multipart upload. A response
can contain zero or more
Part
elements.
|
PartNumber
|
The number that identifies the part.
|
LastModified
|
The date and time when the part was uploaded.
|
ETag
|
The
HTTP 1.1 entity tag
that was returned when the part was uploaded.
|
Size
|
Size of the part in bytes.
|
Examples
The following sample lists the uploaded parts for an object named
paris.jpeg
in a bucket named
travel-maps
.
Request
GET /paris.jpeg?uploadId=VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA&max-parts=2 HTTP/1.1
Host: travel-maps.storage.googleapis.com
Date: Wed, 24 Mar 2021 15:31:56 GMT
Content-Length: 0
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Response
HTTP/1.1 200 OK
Content-Length: 764
Content-Type: application/xml
Date: Wed, 24 Mar 2021 23:31:57 GMT
Expires: Wed, 24 Mar 2021 23:31:57 GMT
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>travel-maps</Bucket>
<Key>paris.jpg</Key>
<UploadId>VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
<StorageClass>STANDARD</StorageClass>
<PartNumberMarker>1</PartNumberMarker>
<NextPartNumberMarker>5</NextPartNumberMarker>
<MaxParts>2</MaxParts>
<IsTruncated>true</IsTruncated>
<Part>
<PartNumber>2</PartNumber>
<LastModified>2020-11-10T20:48:34.000Z</LastModified>
<ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
<Size>10485760</Size>
</Part>
<Part>
<PartNumber>5</PartNumber>
<LastModified>2020-11-10T20:48:33.000Z</LastModified>
<ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
<Size>10485760</Size>
</Part>
</ListPartsResult>