本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 什麼是 EventBridge 自訂事件匯流排？
<a name="eb-custom-bus-what-is"></a>

EventBridge 自訂事件匯流排是一個無伺服器事件匯流排，一個團隊執行，許多團隊和帳戶使用。您可以使用 `PutEvents`或 將事件發佈至其中`PutRawEvents`。它會將每個事件路由到其篩選條件相符的訂閱者，並在您在匯流排上設定的保留期間內保留每個事件的副本。您可以透過 AWS Resource Access Manager (AWS RAM) 與其他帳戶共用匯流排，而每個帳戶都會連接自己的訂閱者。匯流排擁有者不會代其寫入任何路由。

在 EventBridge 主控台中，匯流排類型會顯示為此匯流排的**自訂事件匯流排**，以及使用規則和目標的匯流排的**自訂事件匯流排 - Classic**。如需 CLI、 SDK 和 IAM 名稱，請參閱 [自訂事件匯流排的名稱、端點和 IAM 許可](eb-custom-bus-names.md)。

## 主要功能
<a name="eb-custom-bus-what-is-features"></a>
+ 透過 跨帳戶共用 AWS RAM，具有四個受管許可，可讓取用者帳戶發佈、訂閱、連接事件來源或全部三個。
+ 保留每個事件 1 到 365 天，在匯流排上設定。
+ 每個訂閱用戶在事件群組內的排序 (FIFO) 交付。
+ 每個訂閱者的起始位置，因此新訂閱者可以讀取保留的事件，而暫停的訂閱者可以繼續而不會遺失。
+ 在 5 分鐘內，依內容或您提供的金鑰在發佈時間進行重複資料刪除。
+ `PutRawEvents` 適用於 JSON、Avro、Protobuf 或原始位元組，具有用於篩選的結構描述登錄檔還原序列化。
+ 直接呼叫任何狀態變更 AWS API 動作的通用目標，以及自訂目標。

## Resources
<a name="eb-custom-bus-what-is-resources"></a>

您使用三個資源。

事件匯流排  
事件匯流排會接收您使用 `PutEvents`或 發佈的事件`PutRawEvents`，將它們路由到訂閱者，並保留它們。您可以在匯流排上設定保留期間、選用 AWS KMS 金鑰和選用的跨帳戶共用。如需匯流排通過的狀態，請參閱 [匯流排狀態和每個允許的項目](eb-custom-bus-create.md#eb-custom-bus-lifecycle-states)。

Subscriber  
訂閱者會使用篩選條件和接收事件的目標來命名您想要的事件。您可以使用 建立它`CreateSubscriber`。它會監看一個匯流排，保留符合其篩選條件的事件，選擇性地轉換每個匯流排，並將其傳遞給剛好一個目標。若要將事件傳送至多個目標，請為每個目標建立一個訂閱者。

事件來源  
事件來源會從 AWS 服務或軟體即服務 (SaaS) 合作夥伴將事件擷取到匯流排。您可以使用 建立它`CreateEventSource`，命名原始伺服器和目的地匯流排，EventBridge 會為您移動事件。

匯流排和訂閱者 Amazon Resource Name (ARNs) 結尾為 EventBridge 產生的識別符，例如 `arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef`。存放完整的 ARN 而非名稱。如果您刪除匯流排並使用相同名稱建立另一個匯流排，則新匯流排會有不同的識別符。

## 一個匯流排，許多帳戶
<a name="eb-custom-bus-what-is-sharing"></a>

若要讓另一個帳戶使用您的匯流排，請與 共用並 AWS RAM 連接其中一個受管許可，例如`AWSRAMEventBridgeEventBusV2SubscribeOnly`讓該帳戶連接訂閱者。然後，帳戶會在您的匯流排上建立並擁有自己的訂閱者：它只會在列出訂閱者時看到，而您會看到所有訂閱者。消費者帳戶無法變更或刪除匯流排，而且您可以使用 撤銷其任何訂閱者`RevokeResource`。如需許可、資源政策和撤銷，請參閱 [與其他 帳戶共用自訂事件匯流排](eb-custom-bus-sharing.md)。

## 自訂事件匯流排如何路由和保留事件
<a name="eb-custom-bus-what-is-retention"></a>

匯流排會在每個事件送達時，將事件路由至相符的訂閱者。匯流排也會將事件保留您設定的天數。保留可讓兩種功能成為可能。
+ 訂閱者可以從過去的某個時間點開始。這就是您重播保留事件的方式，以及您今天建立的訂閱者如何讀取昨天發佈的事件。
+ 訂閱者可以暫停和稍後繼續，而不會遺失事件。

如需詳細資訊，請參閱[選擇保留期間](eb-custom-bus-create.md#eb-custom-bus-create-retention)及[將保留的事件重播給訂閱者](eb-custom-bus-replay.md)。

## 自訂事件匯流排與自訂事件匯流排有何不同 - Classic
<a name="eb-custom-bus-what-is-compare"></a>


| 功能 | 自訂事件匯流排 | 自訂事件匯流排 - Classic | 
| --- | --- | --- | 
| 跨帳戶使用 | 與 共用匯流排 AWS RAM。每個消費者帳戶都會在匯流排上建立並擁有其訂閱者。 | 透過匯流排資源政策授予其他帳戶，或將事件轉送到另一個帳戶中的匯流排。 | 
| Retention | 內建於匯流排中，為您設定的期間。 | 未保留。若要保留事件，請新增封存。 | 
| 排序 | 每個訂閱用戶在事件群組內交付 FIFO。 | 不可用。 | 
| 重新播放 | 訂閱者對保留事件的起始位置。 | 從封存中重播。 | 
| 發佈 APIs | PutEvents 適用於 JSON 和 PutRawEvents 適用於任何格式，包括 Avro 和 Protobuf。 | PutEvents 適用於 JSON。 | 
| 重複資料刪除 | 在發佈時，依內容或您提供的金鑰。 | 不可用。 | 
| 每個路由資源的目標 | 每個訂閱者一個目標。 | 每個規則最多五個目標。 | 

## 使用案例
<a name="eb-custom-bus-what-is-use-cases"></a>
+ 平台團隊會執行一個`orders`匯流排，並與履行、計費和分析團隊的帳戶共用。每個團隊都連接自己的訂閱者；平台團隊永遠不會編輯他們的路由。
+ 付款服務會發佈`EventGroupId`每個帳號的 ，而 FIFO 訂閱者會依序將每個帳戶的事件交付至佇列。
+ 新的分析取用者會以 30 天的開始位置建立，並在趕上即時流量之前讀取一個月的保留事件。

## 定價
<a name="eb-custom-bus-what-is-pricing"></a>

您需為發佈的事件、交付給訂閱者以及保留付費。如需費率，請參閱 [Amazon EventBridge 定價](https://aws.amazon.com/eventbridge/pricing/)。

## 後續步驟
<a name="eb-custom-bus-what-is-next"></a>
+ 了解要在 CLI、 SDKs 和 IAM 中使用的名稱：[自訂事件匯流排的名稱、端點和 IAM 許可](eb-custom-bus-names.md)。
+ 發佈您的第一個事件：[將事件發佈至自訂事件匯流排](eb-custom-bus-publish.md)。
+ 建立交付訂閱者：[訂閱自訂事件匯流排上的事件](eb-custom-bus-subscribers.md)。