介紹每個介面都需要使用的請求參數和返回參數。
公用請求參數
公用請求參數是指每個介面都需要使用到的請求參數。
名稱 | 類型 | 是否必填 | 描述 |
Action | String | 是 | API的名稱。 |
Format | String | 否 | 傳回值的類型,支援JSON與XML。預設為XML。 |
Version | String | 是 | API版本號碼,為日期形式:YYYY-MM-DD,本版本對應為2017-12-14。 |
AccessKeyId | String | 是 | 阿里雲頒發給使用者的訪問服務所用的密鑰ID。查詢使用者的網站。 |
Signature | String | 是 | 簽名結果串,關於簽名的計算方法,請參見簽名機制。 |
SignatureMethod | String | 是 | 簽名方式,目前支援HMAC-SHA1。 |
Timestamp | String | 是 | 請求的時間戳記。日期格式按照ISO8601標準表示,並需要使用UTC時間。格式為:YYYY-MM-ddTHH:mm:ssZ。例如,2016-05-23T12:00:00Z(為北京時間2016年5月23日20點0分0秒) |
SignatureVersion | String | 是 | 簽名演算法版本,目前版本是1.0。 |
SignatureNonce | String | 是 | 唯一隨機數,用於防止網路重放攻擊。使用者在不同請求間要使用不同的隨機數值。 |
樣本
http://business.aliyuncs.com/?SubscriptionType=Subscription
&Format=XML
&SignatureMethod=HMAC-SHA1
&Signature=AAAAAAAAAAAAAAAAAA%3D
&Timestamp=2018-01-18T10%3A57%3A00Z
&AccessKeyId=BBBBBBBBBBBBBBB
&Action=QueryMonthlyBill
&SignatureNonce=CCCCCCCCCCCCCCCC
&Version=2017-12-14
&SignatureVersion=1.0
&BillingCycle=2018-01
公用返回參數
使用者發送的每次介面調用請求,無論成功與否,系統都會返回一個唯一識別碼
樣本。
- XML格式。
<?xml version="1.0" encoding="utf-8"?> <!—結果的根結點--> <介面名稱+Response> <!—返回請求標籤--> <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId> <!—返回結果資料--> </介面名稱+Response>
- JSON格式。
{ "RequestId":"4C467B38-3910-447D-87BC-AC049166F216", /*返回結果資料*/ }