公共请求参数
公共请求参数是指每个接口都需要使用到的请求参数。
名称 | 类型 | 是否必须 | 描述 |
Format | String | 否 | 返回值的类型,支持JSON与XML。默认为XML |
Version | String | 是 | API版本号,为日期形式:YYYY-MM-DD,本版本对应为2015-01-09 |
AccessKeyId | String | 是 | 阿里云颁发给用户的访问服务所用的密钥ID |
Signature | String | 是 | 签名结果串,关于签名的计算方法,请参见 签名机制。 |
SignatureMethod | String | 是 | 签名方式,目前支持HMAC-SHA1 |
Timestamp | String | 是 | 请求的时间戳。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为YYYY-MM-DDThh:mm:ssZ 例如,2015-01-09T12:00:00Z(为UTC时间2015年1月9日12点0分0秒) |
SignatureVersion | String | 是 | 签名算法版本,目前版本是1.0 |
SignatureNonce | String | 是 | 唯一随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值 |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在阿里云的API请求中,公共请求参数是构成每一个API调用的基础部分,确保了请求的安全性、版本控制以及响应格式的可配置性。您提到的这些参数适用于多数阿里云产品的API调用,下面是对每个参数的简要说明及一个示例:
Format(返回值的类型): 指定响应数据的格式,支持JSON和XML。如果不指定,默认为XML。在示例中,通过Format=xml
指定了返回格式为XML。
Version(API版本号): 必须提供,用来指定调用的API接口版本,格式为YYYY-MM-DD。这有助于阿里云在未来对API进行升级时保持向后兼容。
AccessKeyId(访问密钥ID): 阿里云颁发给用户的唯一标识,用于验证请求发起者的身份。
Signature(签名结果串): 通过对请求参数进行特定算法加密得到的字符串,用于验证请求的完整性和来源的合法性。计算方法遵循阿里云提供的签名机制。
SignatureMethod(签名方式): 目前普遍使用的是HMAC-SHA1算法,用于生成Signature。
Timestamp(请求的时间戳): 使用UTC时间,并按照ISO8601标准表示,格式为YYYY-MM-DDThh:mm:ssZ。防止重放攻击,保证请求的新鲜度。
SignatureVersion(签名算法版本): 当前使用的签名算法版本,通常为1.0。
SignatureNonce(唯一随机数): 每次请求都应使用不同的随机数,以增强安全性,防止请求被重复利用。
示例中的URL [url]https://alidns.aliyuncs.com/?Format=xml
展示了一个请求阿里云DNS服务(Alibaba Cloud DNS,即Alidns)的例子,其中仅指定了返回格式为XML。实际调用时,除了Format
外,还需包括其他必要的公共请求参数,并根据具体操作可能还需要包含特定的操作参数(Action及相关细节)。
请注意,为了安全起见,真实的AccessKeyId和Signature等敏感信息不应直接暴露在公开讨论或示例中。在实际应用中,这些参数应通过安全的方式构造并发送。