公共请求参数

最近更新时间:2019-09-05 20:21:27

公共参数是用于标识用户和接口鉴权目的的参数, 如非必要, 在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。

名称 类型 描述 必选
Action String 接口指令的名称,例如: DescribeInstances。
Region String 区域参数,用来标识希望操作哪个区域的实例。可选:
gz:广州,sh:上海,bj:北京,cd:成都
cq:重庆,hk:中国香港,sg:新加坡,th:曼谷
kr:首尔,jp:东京,ru:莫斯科,de:法兰克福
in:孟买,ca:多伦多,usw:硅谷,use:弗吉尼亚
Timestamp UInt 当前 UNIX 时间戳。
Nonce UInt 随机正整数,与 Timestamp 联合起来,用于防止重放攻击。
SecretId String 由腾讯云平台上申请的标识身份的 SecretId 和 SecretKey,其中 SecretKey 会用来生成 Signature
具体参考 接口鉴权 页面。
Signature String 请求签名,用来验证此次请求的合法性,
具体参考 接口鉴权 页面。

一个典型的接口请求如下,Action=DescribeInstance 表示查询云服务器实例的详情。

https://domain/v2/index.php?Action=DescribeInstances
&SecretId=xxxxxxx
&Region=gz
&Timestamp=1402992826
&Nonce=345122
&Signature=mysignature
&instanceId=101

其中 instanceId 为指令参数,其余为公共参数。