All Products
Search
Document Center

Drive and Photo Service:ListUploadedParts

Last Updated:May 12, 2026

Lists the parts that have been successfully uploaded for a specific multipart upload.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/file/list_uploaded_parts HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

domain_id

string

Yes

body

object

No

The request body.

part_number_marker

integer

No

The marker that specifies the position after which to start listing parts. Obtain this value from the next_part_number_marker field in a previous response. If this parameter is omitted, the listing starts from the first part.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

limit

integer

No

The maximum number of parts to return. The value cannot exceed 100. The default is 100.

100

upload_id

string

Yes

The upload ID.

00166D06127B413BA1EC8ABB1144D101

file_id

string

Yes

The file ID.

322fb07b975f4b0ae1b543fe8475eee4c19eb2b2

drive_id

string

No

The drive ID. Required for all scenarios except uploads from a share.

1

share_id

string

No

The share ID. Required when uploading from a share.

7JQX1FswpQ8

Response elements

Element

Type

Description

Example

object

The response object.

file_id

string

The file ID.

322fb07b975f4b0ae1b543fe8475eee4c19eb2b2

upload_id

string

The upload ID.

00166D06127B413BA1EC8ABB1144D101

uploaded_parts

array

A list of uploaded parts.

UploadPartInfo

Information about a single part.

next_part_number_marker

string

The marker for the next page of results. This value is empty when there are no more results to return.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

parallel_upload

boolean

Indicates whether parallel upload is enabled.

false

Examples

Success response

JSON format

{
  "file_id": "322fb07b975f4b0ae1b543fe8475eee4c19eb2b2",
  "upload_id": "00166D06127B413BA1EC8ABB1144D101",
  "uploaded_parts": [
    {
      "part_number": 1,
      "part_size": 1024,
      "upload_url": "https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661",
      "internal_upload_url": "https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\n",
      "etag": "\"0CC175B9C0F1B6A831C399E269772661\"",
      "parallel_sha1_ctx": {
        "h": [
          0
        ],
        "part_offset": 10240
      },
      "upload_form_info": {
        "endpoint": "",
        "form_data": {
          "key": ""
        }
      },
      "parallel_sha256_ctx": {
        "h": [
          0
        ],
        "part_offset": 0
      }
    }
  ],
  "next_part_number_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
  "parallel_upload": false
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.