全部產品
Search
文件中心

Data Management:DescribeInventoryFileUploadSignature

更新時間:Jun 17, 2026

取得資產盤點檔案 OSS 直傳憑證。

介面說明

為資產盤點上傳文件產生 OSS PostObject V4 直傳簽章。用戶端使用傳回的 uploadHost、uploadDir、policy、ossCredential、ossDate、ossSignature、ossSecurityToken 直傳檔案;上傳成功後將 OSS key 作為 CreateInventoryJob 的 InputFiles 傳入。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST / HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

JobToken

string

上傳目錄冪等標識,可傳盤點任務草稿 ID 或用戶端產生 UUID;不傳則伺服端產生隨機目錄。

inventory-draft-20260613

返回參數

名稱

類型

描述

樣本值

object

傳回內容。

RequestId

string

Id of the request

0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931

ErrorCode

string

錯誤碼。

UnknownError

ErrorMessage

string

錯誤資訊。

UnknownError

Success

boolean

請求是否成功。

true

Data

object

OSS 直傳簽章資訊。

OssCredential

string

指明衍生金鑰的參數集。

eyJleHBpcmFxxx

OssDate

string

請求的時間,其格式遵循 ISO 8601 日期和時間標準。

20260617T093434Z

OssSignatureVersion

string

指定簽章的版本和演算法。

OSS4-HMAC-SHA256

OssSignature

string

用於簽章認證的描述資訊。

6475cdb70e1a5xxx

OssSecurityToken

string

上傳到 OSS 使用的 STS token,1 小時有效。

CAIS5QJ1q6Ft5xxx

Policy

string

策略內容。

eyJleHBpcxxx

UploadHost

string

檔案上傳的目標位址。

https://dms-metaagentxxx

UploadDir

string

檔案上傳的路徑。

metaagent_inventory/xxx

MaxFileSizeBytes

integer

上傳檔案的最大限制。

209715200

樣本

正常返回樣本

JSON格式

{
  "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
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情