S3 · Multipart uploads

ListParts

GET/{bucket}/{key}?uploadId

Lists the parts of a multipart upload.

Returns every part that storage has for the upload, in part number order.

View as Markdown

Role: Viewer or higher
Support: Supported
Auth: SigV4 with your API key

Lists the parts of one upload, in part order.
The response has every part on one page. Storage ignores max-parts and part-number-marker.

Request

https://wspq7ws2np5l8z4.storage.beta.graphon.sh/support-tickets/big.bin?uploadId=VXBsb2FkIGZvciBiaWcuYmlu

GET /support-tickets/big.bin?uploadId=VXBsb2FkIGZvciBiaWcuYmlu HTTP/1.1
Host: wspq7ws2np5l8z4.storage.beta.graphon.sh
x-amz-date: 20261007T093000Z
x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Authorization: AWS4-HMAC-SHA256 Credential=<ACCESS_KEY_ID>/20261007/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=<SIGNATURE>

Replace wspq7ws2np5l8z4 with your workspace ID. HTTP shows the signed request on the wire. The aws CLI and the SDKs sign for you. The CLI uses the graphon profile, and the SDK samples read GRAPHON_API_KEY.

Response

200

The parts of the upload.

HTTP/1.1 200 OK
Content-Type: application/xml
x-amz-request-id: 4F8A2C7D1E6B4093A5C2D8E1F7B3A960

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>support-tickets</Bucket>
  <Key>big.bin</Key>
  <UploadId>VXBsb2FkIGZvciBiaWcuYmlu</UploadId>
  <Part>
    <PartNumber>1</PartNumber>
    <ETag>"7ac66c0f148de9519b8bd264312c4d64"</ETag>
    <Size>104857600</Size>
  </Part>
</ListPartsResult>

Path parameters

bucketstringrequired

The bucket name.

keystringrequired

The object key. Keep each / as it is. Percent-encode the other reserved characters.

Query parameters

uploadIdstringrequired

The upload ID from CreateMultipartUpload.

Headers

x-amz-expected-bucket-ownerstringoptional

The workspace ID that must own the bucket. Another owner returns 403 AccessDenied.

Responses

200OK

The parts of the upload.

application/xml

ListPartsResultobjectrequired

The root element.

Bucketstring

The bucket name.

Keystring

The object key.

UploadIdstring

The upload ID.

Partarray

One element for each part.

Errors

Select an error in the response example to see its XML body. Any request can also get the common errors, such as SignatureDoesNotMatch.

404NoSuchUpload

The upload ID is not known for this key. The upload was completed or aborted.

What to do: Start a new upload with CreateMultipartUpload.

404NoSuchBucket

No bucket has this name, or the bucket was deleted.

What to do: Check the bucket name. ListBuckets shows the buckets of the workspace.

403AccessDenied

The key does not have the role for this operation, or the bucket is in another workspace.

What to do: Use a key of the workspace that owns the bucket, with the role above.

Was this page helpful?