Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在自定义事件总线上订阅事件

订阅者是一种资源，它说明你想要哪些事件以及将它们发送到哪里。你可以使用它来创建它CreateSubscriber，命名总线、过滤器和一个目标。它监视该总线，保留与其过滤器匹配的事件，选择性地转换每个总线，然后将其传送到一个目标。要将一个事件传播到多个目标，请在同一条总线上为每个目标创建一个订阅者。

EventBridge 在给定总线上一次应用一个订阅者创建或删除，无论哪个账户调用。正在运行的另一DeleteSubscriber条总线CreateSubscriber或在同一条总线上运行时失败ConcurrentModificationException；重试。自定义事件总线配额因此，中的创建和删除费率适用于每条总线。

筛选哪些事件到达目标

FilterConfiguration包含的清单Filters。每个过滤器都有一个Pattern、 EventBridge 事件模式语法和一个Scope。每个范围最多只能有一个过滤器，并且仅当它与列表中的每个过滤器匹配时才会 EventBridge 传递事件。没有 a 的订阅者FilterConfiguration会收到总线上的所有事件。

有关模式语法、范围规则和示例，请参见为订阅者筛选事件。

改造有效载荷

Transformer.Type选择目标接收的内容。通用目标不使用它；参见自定义事件总线的通用目标。

EventBridge 创建订阅者时检查表达式的语法，并在交付时对其进行评估。抛出或不产生任何值的表达式会导致该事件的传递失败。在依赖真实事件之前，先根据真实事件测试表达式。有关有效$events内容、额外功能和限制，请参阅使用 JSonata 转换事件。

实现一个目标

InvokeConfiguration携带TargetArn、 EventBridge 假RoleArn定调用目标的，以及最多一个与目标类型匹配的参数块。大多数参数值接受 JSonata 表达式，因此值可以来自事件。下表列出了定制的目标类型及其参数块；每种目标类型下自定义事件总线订阅者的目标都有自己的页面。

自定义事件总线或自定义事件总线-经典也可以作为目标：将总线 ARN 设置为TargetArn。对于 FIFO 目标（例如 SqsParameters.MessageDeduplicationId Amazon SQS FIFO 队列），在参数块中将目标自己的重复数据删除标识符设置为使用 JSonata 表达式从事件中派生的每条消息值。常量使目标丢弃第一条消息之后的每条消息。

通用目标直接调用 Amazon API 操作，中间没有函数。例如 arn:aws:events:::aws-sdk:service:apiActionarn:aws:events:::aws-sdk:dynamodb:putItem，它的 ARN 具有表单，它将请求UniversalTargetParameters.Input保存为 JSON 或生成该请求的 JSONata 表达式。有关命名规则、批处理和失败行为，请参见自定义事件总线的通用目标。

创建订阅者时，从 ARN EventBridge 解析目标类型并检查三件事：参数块是否与目标类型匹配、ARN 是否属于您的账户，以及每个表达式是否解析。在交付时会检查目标是否存在、角色是否可以到达目标以及目标的 API 是否接受这些值，因此请在目标处确认首次交付。

重试和死信队列

RetryPolicy设置交付失败的 EventBridge 重试时间（默认情况下，在 300 秒内重试 5 次），并OnFailureConfiguration.Arn命名接收每个耗尽重试次数的事件记录的 Amazon SQS 队列。创建订阅者时同时设置两者。有关限制、录制格式以及如何重新驾驶，请参阅重试策略和死信队列。

交付角色

中的角色RoleArn必须属于您的账户并信任events.amazonaws.com服务主体。您的呼叫者需要iam:PassRole该角色才能创建订阅者，或者在检查目标 ARN 之前 EventBridge 拒绝该请求。该角色的权限策略需要两次授权。

以下信任策略 EventBridge 允许代入该角色。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": { "Service": "events.amazonaws.com" },
            "Action": "sts:AssumeRole"
        }
    ]
}

以下权限策略将死信传送到 Amazon SQS 队列，并将死信传送到第二个队列。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "InvokeTheTarget",
            "Effect": "Allow",
            "Action": "sqs:SendMessage",
            "Resource": "arn:aws:sqs:us-east-1:111122223333:large-orders"
        },
        {
            "Sid": "WriteToTheDeadLetterQueue",
            "Effect": "Allow",
            "Action": "sqs:SendMessage",
            "Resource": "arn:aws:sqs:us-east-1:111122223333:large-orders-dlq"
        }
    ]
}

示例：向队列交付大宗订单

以下命令创建一个订阅者，该订阅者将超过 500 的订单交付到 Amazon SQS 队列中，以处理发布的事件PutEvents，并将失败情况发送到死信队列。

aws eventsv2 create-subscriber \
    --name large-orders \
    --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \
    --filter-configuration '{
        "Filters": [
            { "Scope": "DATA", "Pattern": "{\"detail\":{\"total\":[{\"numeric\":[\">\",500]}]}}" }
        ]
    }' \
    --invoke-configuration '{
        "TargetArn": "arn:aws:sqs:us-east-1:111122223333:large-orders",
        "RoleArn": "arn:aws:iam::111122223333:role/EventBusDeliveryRole"
    }' \
    --on-failure-configuration '{ "Arn": "arn:aws:sqs:us-east-1:111122223333:large-orders-dlq" }'

疑难解答：你发布了但没有到达目标

发布者的回应仅表示公交车接受并存储了该事件；它从未确认交付。按顺序完成以下检查。