Retrieves the upload address.
Try it now
Test
RAM authorization
Request syntax
POST /v2/file/get_upload_url HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| domain_id |
string |
Yes |
||
| body |
object |
No |
The request body. |
|
| drive_id |
string |
Yes |
The drive ID. |
1 |
| share_id |
string |
No |
The share ID. |
7JQX1FswpQ8 |
| file_id |
string |
Yes |
The file ID. |
5d5b846942cf94fa72324c14a4bda34e81da635d |
| upload_id |
string |
Yes |
The upload ID. |
10166D06127B413BA1EC8ABB1144D111 |
| part_info_list |
array<object> |
Yes |
A list of file parts. |
|
|
array<object> |
No |
Information about a single file part. |
||
| part_number |
integer |
No |
The part number. |
1 |
| parallel_sha1_ctx |
object |
No |
The SHA1 context for all data preceding this part. This parameter applies only to parallel uploads. |
|
| h |
array |
No |
The five 32-bit state variables of the SHA1 context for all data preceding this part. This parameter applies only to parallel uploads. |
|
|
integer |
No |
One of the five 32-bit variables of the SHA1 context. |
1 |
|
| part_offset |
integer |
No |
The total size in bytes of all preceding parts. The value must be a multiple of 64. This parameter applies only to parallel uploads. |
10240 |
| content_md5 |
string |
No |
||
| content_type |
string |
No |
||
| parallel_sha256_ctx |
object |
No |
||
| h |
array |
No |
||
|
integer |
No |
|||
| part_offset |
integer |
No |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response object. |
||
| domain_id |
string |
The domain ID. |
bj1 |
| drive_id |
string |
The drive ID. |
1 |
| file_id |
string |
The file ID. |
5d5b846942cf94fa72324c14a4bda34e81da635d |
| upload_id |
string |
The upload ID. |
10166D06127B413BA1EC8ABB1144D111 |
| create_at |
string |
The creation time. |
2019-09-11T16:34:36.977Z |
| part_info_list |
array |
The list of upload parts. |
|
| UploadPartInfo |
Information about a single part. |
Examples
Success response
JSON format
{
"domain_id": "bj1",
"drive_id": "1",
"file_id": "5d5b846942cf94fa72324c14a4bda34e81da635d",
"upload_id": "10166D06127B413BA1EC8ABB1144D111",
"create_at": "2019-09-11T16:34:36.977Z",
"part_info_list": [
{
"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
}
}
]
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.