List object parts
Lists the uploaded parts for an ongoingXML API multipart upload, returnedin an XML document in the response body.
Parts in the list are ordered sequentially, and the XML API does not returnlists longer than 1000 parts. If there are more parts to return than can fitin the response, the response returns anIsTruncated element with a value oftrue and aNextPartNumberMarker element which you can use in subsequentlisting 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 thepart-number-marker are returned in the list of parts. | No |
uploadId | The multipart upload for which you want to list the parts. | Yes |
Seesigned URL query string parameters for information on the parametersyou include when creating and usingsigned URLs.
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 theuploadIdquery string parameter.
GET /OBJECT_NAME?uploadId=UPLOAD_ID&max-parts=MAX_NUM_PARTS&part-number-marker=PART_NUMBER HTTP/1.1Host:BUCKET_NAME.storage.googleapis.comDate:DATEContent-Length: 0Authorization:AUTHENTICATION_STRING
Response headers
The request can return a variety of response headers depending on the requestheaders you use.
Response body elements
The following response body elements apply to GET Object requests that use theuploadId 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 thepart-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 bymax-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 morePart elements. |
PartNumber | The number that identifies the part. |
LastModified | The date and time when the part was uploaded. |
ETag | TheHTTP 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 namedparis.jpegin a bucket namedtravel-maps.
Request
GET /paris.jpeg?uploadId=VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA&max-parts=2 HTTP/1.1Host: travel-maps.storage.googleapis.comDate: Wed, 24 Mar 2021 15:31:56 GMTContent-Length: 0Authorization: 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>
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-17 UTC.