Swarm API参考 集群API调用方式 公共参数
公共请求头部
公共请求参数是指每个接口都需要使用到的请求参数。
示例GET /clusters HTTP/ 1.1 Host: cs.aliyuncs.com Accept: application/jsonUser- Agent: cs-sdk-python /0.0.1 (Darwin/ 15.2 .0/x86_64; 2.7 .10)x-acs-signature- nonce: f63659d4 -10ac -483b -99da-ea8fde61eae3 Authorization: acs ACSbW2iBbyX0Pk9N:mp /6Wdr18V3qAc5gbgsqMe/iB0cx-acs-signature- version: 1.0 Date: Wed, 16 Dec 2015 11: 18: 47 GMTx-acs-signature- method: HMAC-SHA1Content- Type: application/json;charset=utf -8X-Acs-Region- Id: cn-beijingContent- Length: 0
公共返回头部
您发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码 RequestId。
示例
XML 示例：<?xml version= "1.0" encoding= "UTF-8"?>< !—结果的根结点-->< 接口名称+Response>| < !—返回请求标签-->| < RequestId>4C467B38-3910-447D-87BC-AC049166F216</ RequestId>| < !—返回结果数据--></ 接口名称+Response>
JSON 示例：{"RequestId": "4C467B38-3910-447D-87BC-AC049166F216"/* 返回结果数据 */}
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
公共请求头部是阿里云API调用中不可或缺的一部分，它们确保了请求的合法性、完整性及安全性。以下是关键公共请求参数的详细说明：
-
Authorization: 用于验证请求合法性的认证信息，格式为
AccessKeyId:Signature。其中，AccessKeyId是用户的访问密钥ID，而Signature是对请求进行签名后的结果，确保请求未被篡改。 -
Content-Length: 指定HTTP请求内容的长度，遵循RFC 2616标准，确保服务器能正确处理请求体大小。
-
Content-Type: 定义了请求内容的类型，如
application/x-www-form-urlencoded; charset=UTF-8或application/json，帮助服务器正确解析请求数据。 -
Content-MD5: 表示HTTP消息体的128位MD5散列值经BASE64编码的结果，作为数据完整性的校验手段，推荐所有请求携带此头以防止篡改。
-
Date: 标识请求构造的时间，需采用GMT格式。与服务器时间差异超过15分钟将导致请求被视为非法。
-
Host: 指定请求的目标服务地址，例如
diku.aliyuncs.com，确保请求路由到正确的服务端点。 -
Accept: 指定客户端期望的响应内容类型，支持
application/json和application/xml，影响返回数据的格式。 -
x-acs-version: API版本号，如
2015-12-15，确保请求与服务端接口版本兼容。 -
x-acs-region-id: 指定操作的地域ID，如
cn-beijing，与ECS实例所在的物理位置相关联。 -
x-acs-signature-nonce: 一个唯一随机数，用于防御网络重放攻击，每次请求应使用不同的随机值。
-
x-acs-signature-method: 签名算法标识，当前仅支持
HMAC-SHA1。
示例请求头:
GET /clusters HTTP/1.1
Host: cs.aliyuncs.com
Accept: application/json
User-Agent: cs-sdk-python/0.0.1 (Darwin/15.2.0/x86_64;2.7.10)
x-acs-signature-nonce: f63659d4-10ac-483b-99da-ea8fde61eae3
Authorization: acs ACSbW2iBbyX0Pk9N:mp/6Wdr18V3qAc5gbgsqMe/iB0cx
x-acs-signature-version: 1.0
Date: Wed, 16 Dec 2015 11:18:47 GMT
x-acs-signature-method: HMAC-SHA1
Content-Type: application/json;charset=utf-8
X-Acs-Region-Id: cn-beijing
Content-Length: 0
至于公共返回头部，每次调用接口后，无论成功还是失败，系统都会在响应中包含一个RequestId，它是一个唯一的识别码，用于追踪和排查问题。示例中的RequestId展示如下：
- XML示例:
<RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId> - JSON示例:
{"RequestId": "4C467B38-3910-447D-87BC-AC049166F216"}
这些返回头部信息有助于开发者定位请求状态，便于后续的调试和监控。
