建立匯流排

您可以使用 建立匯流排CreateEventBus，例如 aws eventsv2 create-event-bus --name orders。名稱是唯一必要的參數。在建立時，您也可以設定描述、匯流排保留事件的天數、加密事件的 AWS KMS 金鑰，以及標籤。呼叫會在匯流排處於 CREATING 狀態時一次傳回 ；發佈至匯流排或在DescribeEventBus報告 後建立訂閱者ACTIVE。

使用 建立匯流排 AWS CLI

下列命令會建立名為 的匯流排orders，該匯流排會保留事件 30 天、使用 AWS KMS 金鑰加密事件，並帶有一個標籤。

aws eventsv2 create-event-bus \
    --name orders \
    --description "Order events from the checkout service" \
    --storage-configuration RetentionPeriodInDays=30 \
    --encryption-configuration KmsKeyIdentifier=arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
    --tags team=orders

下表列出每個參數接受的項目。

參數	接受的內容
--name	必要。1 到 256 個字元：字母、數字、句點、連字號和底線，以字母或數字開頭。名稱在 區域中的帳戶中必須是唯一的；使用相同名稱建立第二個匯流排時， 會失敗ResourceAlreadyExistsException。
--description	最多 512 個字元。
--storage-configuration	RetentionPeriodInDays，從 1 到 365。省略它，匯流排會保留事件 1 天。您可以稍後使用 變更期間UpdateEventBus。請參閱 選擇保留期間。
--encryption-configuration	KmsKeyIdentifier： AWS KMS 客戶受管金鑰的金鑰 ID、金鑰 ARN、別名名稱或別名 ARN。省略它，EventBridge 會使用 AWS 擁有的金鑰加密事件。如需金鑰所需的金鑰政策，請參閱 加密自訂事件匯流排上的事件。
--tags	標籤索引鍵與值的映射，例如 team=orders,env=prod。如需標籤型存取控制，請參閱 自訂事件匯流排的動作、資源和條件索引鍵。

回應會傳回匯流排 ARN，之後每次在匯流排上呼叫都會使用該 ARN。ARN 結尾為 EventBridge 產生的識別符，因此您無法從名稱建構它。

{
    "EventBusArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef",
    "Name": "orders",
    "Description": "Order events from the checkout service",
    "EncryptionConfiguration": {
        "KmsKeyIdentifier": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
    },
    "StorageConfiguration": {
        "RetentionPeriodInDays": 30,
        "RetentionWindowStartTime": "2026-09-21T16:00:00+00:00"
    },
    "State": "CREATING",
    "CreationTime": "2026-09-21T16:00:00+00:00"
}

依其 ARN 描述匯流排，直到 State為 ACTIVE。

aws eventsv2 describe-event-bus \
    --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef

若要 CloudFormation 改為使用 建立匯流排，請參閱 使用 建立自訂事件匯流排資源 CloudFormation。如需建立和描述匯流排所需的 IAM 動作，請參閱 自訂事件匯流排的動作、資源和條件索引鍵。

選擇保留期間

匯流排會保留其接受的每個事件數StorageConfiguration.RetentionPeriodInDays，從 1 到 365；省略它，而匯流排會保留事件 1 天。保留可讓訂閱者從過去的某個時間點開始、暫停和繼續而不會遺失事件，並在失敗後再次讀取事件。較長的期間需要更多的儲存體。您可以稍後使用 變更期間UpdateEventBus。

aws eventsv2 create-event-bus \
    --name orders \
    --storage-configuration RetentionPeriodInDays=30

DescribeEventBus 傳回 RetentionWindowStartTime，這是訂閱者可以從中讀取的最早時間點。若要將保留的事件交付給訂閱者，請參閱 將保留的事件重播給訂閱者。

匯流排狀態和每個允許的項目

建立、更新和刪除匯流排是非同步的。以外的每個狀態都會ACTIVE拒絕某些操作，而三個失敗狀態會附帶 StateReason ，告訴您原因。下表列出匯流排通過的狀態，以及您可以在其中執行的動作。

State	匯流排如何到達	您可以做什麼
CREATING	CreateEventBus 傳回 ，且正在設定匯流排。	描述並等待。您無法發佈、更新或刪除匯流排，或在匯流排上建立訂閱者或事件來源。
ACTIVE	建立或更新完成。	一切：發佈、建立訂閱者和事件來源、更新、共用、刪除。
CREATE_FAILED	建立失敗，當 EventBridge 無法使用您命名的 AWS KMS 金鑰時發生。	刪除匯流排。不接受其他項目。讀取 StateReason、修正金鑰或其政策，然後再次建立匯流排。
UPDATING	UpdateEventBus 正在變更加密組態。其他更新不會通過此狀態。	正常發佈和交付。在匯流排回到 之前，您無法更新或刪除匯流排ACTIVE。
UPDATE_FAILED	加密更新失敗，因為 EventBridge 無法使用 金鑰。	匯流排會繼續以其先前的組態執行。修正原因後重試更新，或刪除匯流排。
DELETING	DeleteEventBus 傳回。	等候。您無法在要刪除的匯流排上建立訂閱者或事件來源。
DELETE_FAILED	刪除找到未撤銷的訂閱者或事件來源。	在刪除或撤銷其訂閱者和事件來源之後，再次刪除匯流排。不接受其他項目。

刪除具有訂閱者的匯流排

DeleteEventBus 只有在刪除或撤銷匯流排上的每個訂閱者和事件來源時， 才會成功。另一個帳戶建立的訂閱者計數。您無法自行刪除該帳戶的訂閱者，因此請要求擁有者刪除該帳戶或使用 將其撤銷RevokeResource；請參閱 撤銷訂閱者或事件來源。如果在檢查和刪除之間建立訂閱者，匯流排會登陸 ；DELETE_FAILED處理新訂閱者並再次刪除。

從失敗的金鑰變更復原

兩個失敗狀態都表示執行中的匯流排可從 AWS KMS 金鑰到達。當新金鑰的更新失敗時，請在修正金鑰的政策或授權UpdateEventBus後重試。如果新的金鑰本身無法使用，重試可以命名不同的金鑰，因為 EventBridge 未採用失敗的金鑰。在 DescribeEventBus 顯示ACTIVE具有新金鑰的匯流排之前，請勿停用、刪除或移除 EventBridge 對上一個金鑰的存取權；透過變更部分遺失其舊金鑰的匯流排只能透過還原該金鑰來修復或刪除。如需金鑰許可，請參閱 加密自訂事件匯流排上的事件。