路由到API触发

您可以通过事件规则过滤事件,将事件路由到API端点,本文以自定义事件为例介绍将事件路由到API端点的前提条件、操作步骤和结果验证。

前提条件

步骤一:添加自定义事件源

  1. 登录事件总线EventBridge控制台,在左侧导航栏,单击事件总线
  2. 在顶部菜单栏,选择地域,在事件总线页面,单击目标自定义事件总线名称。
  3. 在左侧导航栏,单击事件源,然后单击添加事件源
  4. 添加自定义事件源面板,输入名称描述事件提供方选择自定义应用,然后单击确定

步骤二:创建事件规则

重要

目标服务和事件规则必须处于同一地域。

  1. 登录事件总线EventBridge控制台,在左侧导航栏,单击事件总线
  2. 在顶部菜单栏,选择地域,在事件总线页面,单击目标总线名称。
  3. 在左侧导航栏,单击事件规则,然后单击创建规则
  4. 创建规则面板,完成以下操作,然后单击创建

    1. 配置基本信息页签,自定义规则名称和规则描述

      ZKfEhDfrw5

    2. 配置事件模式页签,选择事件源类型自定义事件源,并选择已创建的事件源,然后单击下一步

      OsYj4F7X68

    3. 配置事件目标页签,配置一下信息,然后单击创建

      1. 选择服务类型API触发

        sh1hgoqjae

      2. 按照下表说明配置基础信息区域的信息。

        配置参数

        示例

        说明

        创建方式

        自定义创建

        支持以下两种方式:

        • 自定义创建:如果您选用此种方式,需要在当前页面创建API端点。

        • 使用已有:如果您选择此种方式,需要您提前创建好API端点。具体操作,请参见创建API端点

        API 目标名称

        testAPI

        自定义API端点名称。

        描述

        自定义描述信息,非必填项。

        HTTP 参数

        • Parameter:Header

        • Key:Content-Type

        • Value:multipart/form-data

        Parameter支持以下三种配置方式:

        • Header:此方式是通过请求头传递元信息。这种方式只能以键值对的形式进行配置。

        • Body:此方式是通过请求体传递实际数据。这种方式支持键值对原始数据两种方式进行配置。

        • Query:此方式是通过URL查询字符串传递参数。这种方式只能以键值对的形式进行配置。

        三种Parameter配置的具体方式如下所示:

        • 键值对:Key支持部分事件固定值完整事件Value同样支持部分事件固定值完整事件

        • 原始数据:需要配置变量模板。具体配置信息,请参见模板

      3. API 配置区域设置以下信息。

        配置项

        示例

        说明

        URL

        https://******

        此URL为需要访问服务端资源的API地址。

        HTTP Method

        GET

        支持以下请求方式获取服务端资源:

        • GET:请求指定的页面信息,并返回实体主体。

        • POST:向指定资源提交数据,请求服务器进行处理。数据被包含在请求体中。

        • PUT:向指定资源位置上传其最新内容。

        • PATCH:用于对资源进行部分修改。

        • DELETE:请求服务器删除指定的资源。

        • HEAD:类似于GET请求,但服务器只返回状态行和头部信息,不返回消息体。

      4. 连接配置区域设置以下信息。

        配置项

        示例

        说明

        配置方式

        新建配置

        支持以下两种配置方式:

        • 新建配置:如果您选择此种方式,需要在当前页面创建Connection。

        • 选择已有:如果选择此种方式,需要您提前创建好Connection。具体操作,请参见创建Connection

        连接名称

        Connection-test

        自定义Connection名称。

        连接描述

        自定义描述信息,非必填项。

        鉴权配置

        无需配置

        支持以下四种鉴权配置:

        • 无需配置:如果您选择此种方式,表示任何访问请求都会被API端点响应。

        • Basic:此种方式为基本身份验证方式,如果您选择此种方式,需要您自定义用于授权用户名密码

        • OAuth 客户端凭据:此种方式是一种更加安全可靠的授权认证方式。

        • API Key:此种方式是一种比较简单的认证方式。如果选择此种方式,需要您自定义API访问的KeyNameKeyValue

        网络选择

        公网

        有以下两种网络类型可以选择:

      5. (可选):展开重试和死信区域,配置重试策略容错策略死信队列。具体配置信息,请参见重试和死信

步骤三:发布事件

  1. 登录事件总线EventBridge控制台,在左侧导航栏,单击事件总线
  2. 在顶部菜单栏,选择地域。
  3. 事件总线页面,找到目标总线,在其右侧操作列单击发布事件

    说明

    仅自定义事件总线支持通过控制台发布事件。

  4. 发布事件至自定义事件总线面板,自定义事件源下拉列表选择已创建的自定义事件源,在事件体代码框输入事件内容,然后单击确定

    说明
    • 事件包含的参数规范,请参见事件概述

    • 单击确定后,会默认复制事件ID。

结果验证

  1. 进入目标事件总线的概览页面。

  2. 在左侧导航栏单击事件追踪,然后单击按时间ID查询页签。

  3. 事件ID对应的文本框中复制事件ID,然后单击查询

  4. 单击目标事件操作列的事件轨迹,查看事件是否投递成功。

    UYyMHxrJvw