公共参数是用于标识用户和接口鉴权目的的参数, 如非必要, 在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
名称 | 类型 | 描述 | 必选 |
Action | String | 接口指令的名称,例如: DescribeInstances。 | 是 |
Region | String | 区域参数,用来标识希望操作哪个区域的实例。可选: gz:广州,sh:上海,bj:北京,cd:成都cq:重庆,hk:中国香港,sg:新加坡,th:曼谷kr:首尔,jp:东京,de:法兰克福in:孟买,usw:硅谷,use:弗吉尼亚 | 是 |
Timestamp | UInt | 当前 UNIX 时间戳。 | 是 |
Nonce | UInt | 随机正整数,与 Timestamp 联合起来,用于防止重放攻击。 | 是 |
SecretId | String | 是 | |
Signature | String | 是 |
一个典型的接口请求如下,Action=DescribeInstances 表示查询云服务器实例的详情。
https://domain/v2/index.php?Action=DescribeInstances&SecretId=xxxxxxx&Region=gz&Timestamp=1402992826&Nonce=345122&Signature=mysignature&instanceId=101
其中 instanceId 为指令参数,其余为公共参数。