Amazon EventBridge¶

Amazon Eventbridge 是一项无服务器事件总线服务，可轻松将您的应用程序与来自各种来源的数据连接起来。EventBridge 提供来自您自己的应用程序、软件即服务 (SaaS) 应用程序和 AWS 服务的实时数据流，并将这些数据路由到诸如 AWS Lambda 之类的目标。您可以设置路由规则来确定将数据发送到何处，以构建实时响应所有数据源的应用程序架构。EventBridge 使您能够构建松散耦合和分布式的事件驱动架构。

先决条件任务¶

要使用这些操作符，您必须执行以下操作：

使用 AWS 控制台或 AWS CLI 创建必要的资源。
通过 pip 安装 API 库。
pip install 'apache-airflow[amazon]'
详细信息请参见 Airflow® 的安装
设置连接.

通用参数¶

aws_conn_id

指向 Amazon Web Services 连接 ID 的引用。如果此参数设置为 None，则使用默认的 boto3 行为，不进行连接查找。否则，使用存储在连接中的凭据。默认值：aws_default

region_name

AWS 区域名称。如果此参数设置为 None 或省略，则将使用 AWS 连接额外参数中的 region_name。否则，使用指定的值而不是连接值。默认值：None

verify

是否验证 SSL 证书。

False - 不验证 SSL 证书。
path/to/cert/bundle.pem - 要使用的 CA 证书包的文件名。如果要使用与 botocore 使用的 CA 证书包不同的 CA 证书包，可以指定此参数。

如果此参数设置为 None 或省略，则将使用 AWS 连接额外参数中的 verify。否则，使用指定的值而不是连接值。默认值：None

botocore_config

提供的字典用于构造 botocore.config.Config。此配置可用于配置避免节流异常、超时等。

示例，有关参数的更多详细信息，请查看 botocore.config.Config¶

{
    "signature_version": "unsigned",
    "s3": {
        "us_east_1_regional_endpoint": True,
    },
    "retries": {
      "mode": "standard",
      "max_attempts": 10,
    },
    "connect_timeout": 300,
    "read_timeout": 300,
    "tcp_keepalive": True,
}

如果此参数设置为 None 或省略，则将使用 AWS 连接额外参数中的 config_kwargs。否则，使用指定的值而不是连接值。默认值：None

注意

指定一个空字典，{}，将覆盖 botocore.config.Config 的连接配置

操作符¶

向 Amazon EventBridge 发送事件¶

要向 Amazon EventBridge 发送自定义事件，请使用 EventBridgePutEventsOperator。

tests/system/amazon/aws/example_eventbridge.py

put_events = EventBridgePutEventsOperator(task_id="put_events_task", entries=ENTRIES)

在 Amazon EventBridge 上创建或更新规则¶

要在 EventBridge 上创建或更新规则，请使用 EventBridgePutRuleOperator。

tests/system/amazon/aws/example_eventbridge.py

put_rule = EventBridgePutRuleOperator(
    task_id="put_rule_task",
    name="example_rule",
    event_pattern='{"source": ["example.myapp"]}',
    description="This rule matches events from example.myapp.",
    state="DISABLED",
)

在 Amazon EventBridge 上启用规则¶

要在 EventBridge 上启用现有规则，请使用 EventBridgeEnableRuleOperator。

tests/system/amazon/aws/example_eventbridge.py

enable_rule = EventBridgeEnableRuleOperator(task_id="enable_rule_task", name="example_rule")

在 Amazon EventBridge 上禁用规则¶

要在 EventBridge 上禁用现有规则，请使用 EventBridgeDisableRuleOperator。

tests/system/amazon/aws/example_eventbridge.py

disable_rule = EventBridgeDisableRuleOperator(
    task_id="disable_rule_task",
    name="example_rule",
)

参考¶

EventBridge 的 AWS boto3 库文档