Lists the parts that have been successfully uploaded for a specific multipart upload.
Try it now
Test
RAM authorization
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 |
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.