您可以通过事件规则过滤事件,将事件路由到API端点,本文以自定义事件为例介绍将事件路由到API端点的前提条件、操作步骤和结果验证。
前提条件
步骤一:添加自定义事件源
- 登录事件总线EventBridge控制台,在左侧导航栏,单击事件总线。
- 在顶部菜单栏,选择地域,在事件总线页面,单击目标自定义事件总线名称。
- 在左侧导航栏,单击事件源,然后单击添加事件源。
在添加自定义事件源面板,输入名称和描述,事件提供方选择自定义应用,然后单击确定。
步骤二:创建事件规则
目标服务和事件规则必须处于同一地域。
- 登录事件总线EventBridge控制台,在左侧导航栏,单击事件总线。
- 在顶部菜单栏,选择地域,在事件总线页面,单击目标总线名称。
- 在左侧导航栏,单击事件规则,然后单击创建规则。
在创建规则面板,完成以下操作,然后单击创建。
在配置基本信息页签,自定义规则名称和规则描述。
在配置事件模式页签,选择事件源类型为自定义事件源,并选择已创建的事件源,然后单击下一步。
在配置事件目标页签,配置一下信息,然后单击创建。
选择服务类型为API触发。
按照下表说明配置基础信息区域的信息。
配置参数
示例
说明
创建方式
自定义创建
支持以下两种方式:
自定义创建:如果您选用此种方式,需要在当前页面创建API端点。
使用已有:如果您选择此种方式,需要您提前创建好API端点。具体操作,请参见创建API端点。
API 目标名称
testAPI
自定义API端点名称。
描述
无
自定义描述信息,非必填项。
HTTP 参数
Parameter:Header
Key:
Content-Type
Value:
multipart/form-data
Parameter支持以下三种配置方式:
Header:此方式是通过请求头传递元信息。这种方式只能以键值对的形式进行配置。
Body:此方式是通过请求体传递实际数据。这种方式支持键值对或原始数据两种方式进行配置。
Query:此方式是通过URL查询字符串传递参数。这种方式只能以键值对的形式进行配置。
三种Parameter配置的具体方式如下所示:
键值对:Key支持部分事件、固定值或完整事件,Value同样支持部分事件、固定值或完整事件。
原始数据:需要配置变量和模板。具体配置信息,请参见模板。
在API 配置区域设置以下信息。
配置项
示例
说明
URL
https://******
此URL为需要访问服务端资源的API地址。
HTTP Method
GET
支持以下请求方式获取服务端资源:
GET:请求指定的页面信息,并返回实体主体。
POST:向指定资源提交数据,请求服务器进行处理。数据被包含在请求体中。
PUT:向指定资源位置上传其最新内容。
PATCH:用于对资源进行部分修改。
DELETE:请求服务器删除指定的资源。
HEAD:类似于GET请求,但服务器只返回状态行和头部信息,不返回消息体。
在连接配置区域设置以下信息。
配置项
示例
说明
配置方式
新建配置
支持以下两种配置方式:
新建配置:如果您选择此种方式,需要在当前页面创建Connection。
选择已有:如果选择此种方式,需要您提前创建好Connection。具体操作,请参见创建Connection。
连接名称
Connection-test
自定义Connection名称。
连接描述
无
自定义描述信息,非必填项。
鉴权配置
无需配置
支持以下四种鉴权配置:
无需配置:如果您选择此种方式,表示任何访问请求都会被API端点响应。
Basic:此种方式为基本身份验证方式,如果您选择此种方式,需要您自定义用于授权用户名和密码。
OAuth 客户端凭据:此种方式是一种更加安全可靠的授权认证方式。
API Key:此种方式是一种比较简单的认证方式。如果选择此种方式,需要您自定义API访问的KeyName和KeyValue。
网络选择
公网
有以下两种网络类型可以选择:
(可选):展开重试和死信区域,配置重试策略、容错策略和死信队列。具体配置信息,请参见重试和死信。
步骤三:发布事件
- 登录事件总线EventBridge控制台,在左侧导航栏,单击事件总线。
- 在顶部菜单栏,选择地域。
在事件总线页面,找到目标总线,在其右侧操作列单击发布事件。
说明仅自定义事件总线支持通过控制台发布事件。
在发布事件至自定义事件总线面板,自定义事件源下拉列表选择已创建的自定义事件源,在事件体代码框输入事件内容,然后单击确定。
说明事件包含的参数规范,请参见事件概述。
单击确定后,会默认复制事件ID。
结果验证
进入目标事件总线的概览页面。
在左侧导航栏单击事件追踪,然后单击按时间ID查询页签。
在事件ID对应的文本框中复制事件ID,然后单击查询。
单击目标事件操作列的事件轨迹,查看事件是否投递成功。