公共参数
最近更新时间：2018-11-08 21:18:22
在这篇文章中：
公共参数是用于标识用户和接口鉴权目的的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。
| 参数名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 具体操作的指令接口名称，例如想要调用云服务器的查询实例列表接口，则 Action 参数即为 DescribeInstances 。 |
| Region | String | 是 | 地域参数，用来标识希望操作哪个地域的数据。 |
| Timestamp | Integer | 是 | 当前 UNIX 时间戳，可记录发起 API 请求的时间。例如1529223702，如果与当前时间相差过大，会引起签名过期错误。 |
| Nonce | Integer | 是 | 随机正整数，与 Timestamp 联合起来，用于防止重放攻击。 |
| SecretId | String | 是 | 在云API密钥上申请的标识身份的 SecretId，一个 SecretId 对应唯一的 SecretKey ，而 SecretKey 会用来生成请求签名 Signature。 |
| Signature | String | 是 | 请求签名，用来验证此次请求的合法性，需要用户根据实际的输入参数计算得出。具体计算方法参见接口鉴权文档。 |
| Version | String | 是 | API 的版本。例如 2017-03-12 |
| SignatureMethod | String | 否 | 签名方式，目前支持 HmacSHA256 和 HmacSHA1 。只有指定此参数为 HmacSHA256 时，才使用 HmacSHA256 算法验证签名，其他情况均使用 HmacSHA1 验证签名。 |
| Token | String | 否 | 临时证书所用的 Token ，需要结合临时密钥一起使用。临时密钥和 Token 需要到访问管理服务调用接口获取。长期密钥不需要 Token 。 |
假设用户想要查询广州地域的云服务器实例列表，则其请求链接的形式可能如下:
https://cvm.tencentcloudapi.com/?Action=DescribeInstances &SecretId=xxxxxxx &Region=ap-guangzhou &Timestamp=1402992826 &Nonce=345122 &Signature=xxxxxxxx &Version=2017-03-12
地域列表
本产品所有接口 Region 字段的可选值如下表所示。如果接口不支持该表中的所有地域，则会在接口文档中单独说明。
| 区域 | 取值 |
|---|---|
| 华北地区(北京) | ap-beijing |
| 西南地区(成都) | ap-chengdu |
| 华南地区(广州) | ap-guangzhou |
| 亚太地区(首尔) | ap-seoul |
| 华东地区(上海) | ap-shanghai |
| 华东地区(上海金融) | ap-shanghai-fsi |
| 美国西部(硅谷) | na-siliconvalley |
如果有其他疑问，您也可以在问答社区中寻求帮助。前往问答社区 >