Retrieves OSS direct upload credentials for asset information collection files.
Operation description
Generates an OSS PostObject V4 direct upload signature for asset information collection document uploads. The client uses the returned uploadHost, uploadDir, policy, ossCredential, ossDate, ossSignature, and ossSecurityToken to directly upload files. After a successful upload, pass the OSS key as the InputFiles parameter of CreateInventoryJob.
Try it now
Test
RAM authorization
Request syntax
POST / HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| JobToken |
string |
No |
The idempotency identifier for the upload directory. You can pass an inventory task draft ID or a client-generated UUID. If not specified, the server generates a random directory. |
inventory-draft-20260613 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response body. |
||
| RequestId |
string |
Id of the request |
0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931 |
| ErrorCode |
string |
The error code. |
UnknownError |
| ErrorMessage |
string |
The error message. |
UnknownError |
| Success |
boolean |
Indicates whether the request was successful. |
true |
| Data |
object |
The OSS direct upload signature information. |
|
| OssCredential |
string |
The parameter set that specifies the derived key. |
eyJleHBpcmFxxx |
| OssDate |
string |
The time of the request. The format follows the ISO 8601 date and time standard. |
20260617T093434Z |
| OssSignatureVersion |
string |
The version and algorithm of the signature. |
OSS4-HMAC-SHA256 |
| OssSignature |
string |
The description information used for signature authentication. |
6475cdb70e1a5xxx |
| OssSecurityToken |
string |
The STS token used to upload files to OSS. The token is valid for 1 hour. |
CAIS5QJ1q6Ft5xxx |
| Policy |
string |
The policy content. |
eyJleHBpcxxx |
| UploadHost |
string |
The destination address for file uploads. |
https://dms-metaagentxxx |
| UploadDir |
string |
The path for file uploads. |
metaagent_inventory/xxx |
| MaxFileSizeBytes |
integer |
The maximum size limit for uploaded files. |
209715200 |
Examples
Success response
JSON format
{
"RequestId": "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
"ErrorCode": "UnknownError",
"ErrorMessage": "UnknownError",
"Success": true,
"Data": {
"OssCredential": "eyJleHBpcmFxxx",
"OssDate": "20260617T093434Z",
"OssSignatureVersion": "OSS4-HMAC-SHA256",
"OssSignature": "6475cdb70e1a5xxx",
"OssSecurityToken": "CAIS5QJ1q6Ft5xxx",
"Policy": "eyJleHBpcxxx",
"UploadHost": "https://dms-metaagentxxx",
"UploadDir": "metaagent_inventory/xxx",
"MaxFileSizeBytes": 209715200
}
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.