本文介绍事件总线EventBridge的API的公共请求头和公共返回头信息。
公共请求头部
公共请求参数是指每个接口都需要使用到的请求参数。
| 参数名称 | 示例 | 是否必选 | 说明 |
|---|---|---|---|
| Authorization | acs <yourAccessKeyId>:<yourSignature> | 是 | 用于验证请求合法性的认证信息，采用AccessKeyId:Signature的形式。
|
| Content-Length | 26 | 是 | RFC 2616中定义的HTTP请求内容长度。 |
| Content-Type | application/json | 是 | RFC 2616中定义的HTTP请求内容类型。 |
| Content-MD5 | 0e30656********0bc6f70bbdfe | 是 | HTTP协议消息体的128-bit MD5散列值转换成Base64编码的结果。为了防止所有请求被篡改，建议所有请求都附加该信息。 |
| Date | Sat, 18 Apr 2020 05:30:41 GMT | 是 | 请求的构造时间，目前只支持GMT格式。 |
| Host | cs.aliyuncs.com | 是 | 请求的服务地址，例如：123456789098****.eventbridge.aliyuncs.com。 |
| Accept | application/json | 是 | 客户端需要的返回值类型，支持application/json和application/xml。 |
| x-eventbridge-version | 2020-04-01 | 是 | API版本号。目前版本号为2020-04-01。 |
| x-acs-region-id | cn-beijing | 否 | 地域ID。 |
| x-acs-signature-nonce | f63659d4-10ac-483b-99da-ea8fde61**** | 否 | 唯一随机数，用于防止网络重放攻击。您在不同请求间要使用不同的随机数值。 |
| x-acs-signature-method | HMAC-SHA1 | 是 | 用户签名方式，目前只支持HMAC-SHA1。 |
示例
POST /openapi/createEventBus HTTP/1.1
Host: 123456789098****.eventbridge.cn-hangzhou.aliyuncs.com
Accept: application/json
Date: Sat, 18 Apr 2020 05:30:41 GMT
x-eventbridge-version: 2020-04-01
Authorization: acs vZ3VL0SuJdHi****:Jo2PbTj******zYAYoYslKLvWzg=
Content-Type: application/json;charset=UTF-8
Content-Length: 26公共返回头部
每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码RequestId。调用API服务后返回数据采用统一格式。返回的HTTP状态码如下：
2xx：调用成功。4xx：调用失败。5xx：调用失败。
JSON示例
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166****"
/* 返回结果数据 */
}