公共請求參數
公共請求參數是指調用每個接口都需要使用到的請求參數。
名稱 | 類型 | 是否必須 | 描述 |
Format | String | 否 | 返回值的類型,支持 JSON 與 XML。默認為 XML。 |
Version | String | 是 | API 版本號,為日期形式: |
AccessKeyId | String | 是 | 阿里云頒發給用戶的訪問服務所用的密鑰 ID,可以通過控制臺AccessKey管理來創建。 |
Signature | String | 是 | 簽名結果串,關于簽名的計算方法,請參見簽名機制。 |
SignatureMethod | String | 是 | 簽名方式,目前支持 HMAC-SHA1。 |
Timestamp | String | 是 | 請求的時間戳。日期格式按照 ISO8601 標準表示,并需要使用 UTC 時間。格式為 |
SignatureVersion | String | 是 | 簽名算法版本,目前版本是 1.0。 |
SignatureNonce | String | 是 | 唯一隨機數,用于防止網絡重放攻擊。不同的請求要使用不同的隨機數值。您可以使用UUID(隨機串),也可以自定義。 |
RegionId | String | 否 | 機房信息。具體值請參考文檔中的RegionId字段:API服務地址。 |
示例
https://dm.aliyuncs.com/
?Format=xml
&Version=2015-11-23
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=e1b44502-6d13-4433-9493-69eeb068e955
&SignatureVersion=1.0
&AccessKeyId=key-test
&Timestamp=2015-11-23T12:00:00Z
公共返回參數
用戶發送的每次接口調用請求,無論成功與否,系統都會返回一個唯一識別碼 RequestId。
參數 | 類型 | 描述 |
RequestId | String | 阿里云為該請求生成的唯一標識符。 |
示例
XML示例
<?xml version="1.0" encoding="UTF-8"?>
<!-結果的根結點-->
<接口名稱+Response>
<!-返回請求標簽-->
<RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
<!-返回結果數據-->
</接口名稱+Response>
JSON示例
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
/* 返回結果數據 */
}