云服务器公共参数-云服务器 API 2017-API 中心-腾讯云

说明：
当前页面接口为旧版 API，未来可能停止维护，目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用 云服务器 API 3.0。
公共参数是用于标识用户和接口鉴权目的的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。
参数名称
是否必选
类型
描述
Action
是
具体操作的指令接口名称，例如想要调用 查询实例列表 接口，则 Action 参数即为 DescribeInstances。
String
Region
否
区域参数，用来标识希望操作哪个区域的实例。各区域的参数值为：
北京：ap-beijing，广州：ap-guangzhou，上海：ap-shanghai，中国香港：ap-hongkong，多伦多：na-toronto，硅谷：na-siliconvalley，新加坡：ap-singapore，上海金融：ap-shanghai-fsi，深圳金融：ap-shenzhen-fsi，广州Open专区：ap-guangzhou-open
查看所有 区域和可用区 列表，查看 查询地域列表 API 接口。
注意：1、正常情况下此参数是必须的，如无需传入，则会在相应接口中进行说明。2、部分区域正在内测中，目前仅面向部分用户开放。
String
Timestamp
是
当前 UNIX 时间戳，可记录发起 API 请求的时间。
UInt
Nonce
是
随机正整数，与 Timestamp 联合起来, 用于防止重放攻击。
UInt
SecretId
是
在 云 API 密钥 上申请的标识身份的 SecretId，一个 SecretId 对应唯一的 SecretKey , 而 SecretKey 会用来生成请求签名 Signature。具体可参见 签名方法 页面。
String
Signature
是
请求签名，用来验证此次请求的合法性，需要用户根据实际的输入参数计算得出。计算方法可参见 签名方法 页面。
String
SignatureMethod
否
签名方式，目前支持 HmacSHA256 和 HmacSHA1。只有指定此参数为 HmacSHA256 时，才使用 HmacSHA256 算法验证签名，其他情况均使用 HmacSHA1 验证签名。签名计算方法可参见 签名方法 页面。
String
Token
否
临时证书所用的 Token，需要结合临时密钥一起使用。长期密钥不需要 Token。
String
假设用户想要查询广州地域的云服务器实例列表，则其请求链接的形式可能如下：
https://cvm.api.qcloud.com/v2/index.php?Action=DescribeInstances
&SecretId=xxxxxxx
&Region=ap-guangzhou
&Timestamp=1402992826
&Nonce=345122
&Signature=xxxxxxxx
&Version=2017-03-12
其中 Version 字段为用来表示 DescribeInstances 接口的版本的必传参数。

参数名称	是否必选	类型	描述
Action	是	具体操作的指令接口名称，例如想要调用查询实例列表接口，则 Action 参数即为 DescribeInstances。	String
Region	否	区域参数，用来标识希望操作哪个区域的实例。各区域的参数值为：北京：ap-beijing，广州：ap-guangzhou，上海：ap-shanghai，中国香港：ap-hongkong，多伦多：na-toronto，硅谷：na-siliconvalley，新加坡：ap-singapore，上海金融：ap-shanghai-fsi，深圳金融：ap-shenzhen-fsi，广州Open专区：ap-guangzhou-open 查看所有区域和可用区列表，查看查询地域列表 API 接口。注意：1、正常情况下此参数是必须的，如无需传入，则会在相应接口中进行说明。2、部分区域正在内测中，目前仅面向部分用户开放。	String
Timestamp	是	当前 UNIX 时间戳，可记录发起 API 请求的时间。	UInt
Nonce	是	随机正整数，与 Timestamp 联合起来, 用于防止重放攻击。	UInt
SecretId	是	在云 API 密钥上申请的标识身份的 SecretId，一个 SecretId 对应唯一的 SecretKey , 而 SecretKey 会用来生成请求签名 Signature。具体可参见签名方法页面。	String
Signature	是	请求签名，用来验证此次请求的合法性，需要用户根据实际的输入参数计算得出。计算方法可参见签名方法页面。	String
SignatureMethod	否	签名方式，目前支持 HmacSHA256 和 HmacSHA1。只有指定此参数为 HmacSHA256 时，才使用 HmacSHA256 算法验证签名，其他情况均使用 HmacSHA1 验证签名。签名计算方法可参见签名方法页面。	String
Token	否	临时证书所用的 Token，需要结合临时密钥一起使用。长期密钥不需要 Token。	String