公共请求参数
公共请求参数是指[backcolor=transparent]每个接口都需要使用到的请求参数。
名称 | 类型 | 是否必须 | 描述 |
Version | String | 是 | API 版本,当前版本为:v2 |
AccessKeyId | String | 是 | 阿里云颁发给用户的访问服务所用的密钥ID |
Signature | String | 是 | 签名结果串,关于签名的计算方法,请参见 授权机制。 |
SignatureMethod | String | 是 | 签名方式,目前支持HMAC-SHA1 |
Timestamp | String | 是 | 请求的时间戳。日期格式按照ISO8601标准表示,[backcolor=transparent]必须使用UTC时间。格式为YYYY-MM-DDThh:mm:ssZ 例如,2014-05-26T12:00:00Z(为北京时间2014年5月26日20点0分0秒) |
SignatureVersion | String | 是 | 签名算法版本,目前版本是1.0 |
SignatureNonce | String | 是 | 唯一随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值,建议使用13位毫秒时间戳+4位随机数 |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在与阿里云API进行交互时,公共请求参数是构成每个API请求不可或缺的一部分,它们确保了请求的合法性、安全性和时效性。您提到的这些参数具体解释如下:
Version (版本): 指定调用API的版本号,这对于使用正确的服务接口和功能至关重要。当前示例中使用的版本为v2
。
AccessKeyId: 这是阿里云为您生成的一对密钥中的ID部分,用于标识您的身份。它是访问阿里云服务的凭证之一,必须保密保管。
Signature: 签名结果串,通过将请求方法、请求URL、请求参数以及您的AccessKeySecret等信息按照特定算法(如HMAC-SHA1)计算得出,确保请求未被篡改。
SignatureMethod: 指定生成签名所使用的加密算法。目前支持的通常是HMAC-SHA1
。
Timestamp: 请求的时间戳,用来标识请求发生的具体时间点,要求使用UTC时间,并遵循ISO8601标准格式(例如,2014-05-26T12:00:00Z
)。这有助于防止重放攻击,即同一有效请求被重复发送。
SignatureVersion: 签名算法的版本号,当前示例中使用的是1.0
。
SignatureNonce: 一个随机字符串,用于增加签名唯一性,防止网络重放攻击。每次请求应使用不同的随机值,建议的生成方式可以是当前时间的毫秒级时间戳加上几位随机数字。
基于这些参数,一个典型的阿里云API请求URL示例结构可能如下所示(注意,实际请求中会包含更多特定于操作的参数,这里仅展示公共参数作为示例):
https://$host/$path?Version=v2&AccessKeyId=$yourAccessKeyId&Signature=$yourSignature&SignatureMethod=HMAC-SHA1&Timestamp=$currentTimestamp&SignatureVersion=1.0&SignatureNonce=$yourRandomNonce
请替换$host
、$path
、$yourAccessKeyId
、$yourSignature
、$currentTimestamp
、$yourRandomNonce
等占位符为实际的值。记得在构造签名之前,根据阿里云的官方文档详细了解签名计算的具体步骤,以确保请求能够正确通过验证。