文档首页> 事件网格 EG> 用户指南> 事件
更新时间：2023-10-26 GMT+08:00
查看PDF

事件

事件是符合特定规范的数据。事件源发布到事件网格的事件必须符合CloudEvents规范。

事件网格支持的事件如下。

  • 华为云服务事件：华为云服务事件源产生的事件。
  • 自定义事件：您自定义的事件源接入事件网格产生的事件。您需要自行使用SDK接入事件网格。

事件示例

事件源发布到事件网格的事件示例如下：

{
    "events":[{
	"id": "4b26115b-778e-11ec-833e-cf74******",
        "specversion": "1.0",
	"source": "HC.OBS",
	"type": "object:put",
	"datacontenttype": "application/json",
	"subject": "xxx.jpg",
	"time": "2022-01-17T12:07:48.955Z",
	"data": {
		"name": "test01",
		"state": "enable"
	}
    }]
}

示例中涉及的参数说明如表1所示。

表1 事件参数说明

参数

类型

是否必选

示例值

说明

id

String

是

4b26115b-778e-*******-833e-cf74af

事件ID。标识事件的唯一值。

specversion

String

是

1.0

CloudEvents协议版本。

source

String

是

HC.OBS

事件源。标明事件的来源。

type

String

是

object:put

事件类型。标明与事件源相关的事件类型。

datacontenttype

String

否

application/json

参数“data”的内容格式。

目前只支持application/json格式。

subject

String

否

xxx.jpg

事件主题。标明事件具体的主题形式。

time

Timestamp

否

2022-01-17T12:07:48.955Z

事件产生的时间。

data

Struct

否

 
{
    "name": "test01",
    "state": "enable"
}

事件内容。JSON对象格式。

事件批量发送

事件批量发送请求体的示例如下：

{
    "events":[{
	"id": "eg-test-001",
    "specversion": "1.0",
	"source": "HC.OBS",
	"type": "object:put",
	"datacontenttype": "application/json",
	"subject": "xxx.jpg",
	"time": "2022-01-17T12:07:48.955Z",
	"data": {
		"name": "test01",
		"state": "enable"
	}
    },
	{
	"id": "eg-test-002",
	"specversion": "1.0",
	"source": "HC.OBS",
	"type": "object:put",
	"datacontenttype": "application/json",
	"subject": "xxx.jpg",
	"time": "2022-01-17T12:07:48.955Z",
	"data": {
		"name": "test01",
		"state": "enable"
	}
    },
	{
	"id": "eg-test-003",
	"specversion": "1.0",
	"source": "HC.OBS",
	"type": "object:put",
	"datacontenttype": "application/json",
	"subject": "xxx.jpg",
	"time": "2022-01-17T12:07:48.955Z",
	"data": {
		"name": "test01",
		"state": "enable"
	}
    },...]
}
  • 单事件大小限制：64K。
  • 单条请求所有事件总大小限制：256K。
  • 单条请求事件数量限制：20条。

全部成功的返回体：

{"failed_count":0,"events":[{"error_code":null,"error_msg":null,"event_id":"eg-test-003"},{"error_code":null,"error_msg":null,"event_id":"eg-test-003"},{"error_code":null,"error_msg":null,"event_id":"eg-test-002"}]}

状态码：200

单条请求的事件数量超出限制的返回体：

{"failed_count":1,"events":[{"error_code":"00533012","error_msg":"the number of events exceeds the limit","event_id":"eg-test-003"},{"error_code":null,"error_msg":null,"event_id":"eg-test-003"},{"error_code":null,"error_msg":null,"event_id":"eg-test-002"}]}

状态码：206

单条事件的大小超出限制的返回体：

{"failed_count":3,"events":[{"error_code":00533012,"error_msg":the number of events exceeds the limit,"event_id":"eg-test-003"},{"error_code":00533012,"error_msg":the number of events exceeds the limit,"event_id":"eg-test-003"},{"error_code":00533012,"error_msg":the number of events exceeds the limit,"event_id":"eg-test-002"}]}

状态码：500

单条请求所有事件的总大小超出了限制

{"error_code":"00533007","error_msg":"The total size of a request's all events is too large.","error_detail":"The total size of a request's all events is too large."}
{"error_code":"00533012","error_msg":"An event is too large.","error_detail":"An event is too large."}
{"error_code":"00533013","error_msg":"Too many events for a request.","error_detail":"Too many events for a request."}

状态码：400

状态码为400的情况：

  • 单条请求所有事件的总大小超出了限制。（错误码：EG.00533007；错误信息：The total size of a request's all events is too large）
  • 单条请求的事件数量超出了限制。（错误码：EG.00533013；错误信息：Too many events for a request）