本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 创建巴士
例如`CreateEventBus`，您可以使用创建公交车`aws eventsv2 create-event-bus --name orders`。名称是唯一必需的参数。在创建时，您还可以设置描述、总线保留事件的天数、加密事件的 Amazon KMS 密钥和标记。当公交车处于该`CREATING`状态时，通话会立即返回；发布到公交车或在公交车上创建订阅`DescribeEventBus`者`ACTIVE`。
## 使用创建巴士 Amazon CLI
以下命令创建了一个名为的总线`orders`，该总线将事件保留 30 天，使用您的 Amazon 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。请参阅[选择保留期](#eb-custom-bus-create-retention)。 |
| --encryption-configuration | KmsKeyIdentifier： Amazon KMS 客户管理密钥的密钥 ID、密钥 ARN、别名或别名 ARN。将其省略并 EventBridge 使用 Amazon 自有密钥加密事件。有关密钥需要的密钥政策，请参阅[Amazon EventBridge 自定义事件总线的静态加密](eb-custom-bus-encryption.md)。 |
| --tags | 例如，标签键与值的映射team=orders,env=prod。有关基于标签的访问控制，请参阅[自定义事件总线的操作、资源和条件键](eb-custom-bus-access-actions.md)。 |
响应返回总线 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
```
要 Amazon CloudFormation 改为使用创建总线，请参阅[使用创建自定义事件总线资源 Amazon CloudFormation](eb-custom-bus-cloudformation.md)。有关创建和描述总线所需的 IAM 操作，请参阅[自定义事件总线的操作、资源和条件键](eb-custom-bus-access-actions.md)。
## 选择保留期
总线会保留其接受的所有事件的天数（从 1 到 365）；省略它，总线将事件保留 1 天。`StorageConfiguration.RetentionPeriodInDays`留存可以让订阅者从过去的某个时间点开始，在不丢失事件的情况下暂停和恢复，并在失败后再次阅读事件。时间越长，存储空间越大。您可以稍后使用更改周期`UpdateEventBus`。
```
aws eventsv2 create-event-bus \
--name orders \
--storage-configuration RetentionPeriodInDays=30
```
`DescribeEventBus`返回`RetentionWindowStartTime`，订阅者可以读取的最早点。要将保留的事件交付给订阅者，请参阅[向订阅者重播保留的事件](eb-custom-bus-replay.md)。
## 总线状态及其允许的内容
创建、更新和删除总线是异步的。除拒绝某些操作外，每个状态都`ACTIVE`拒绝某些操作，并且这三个失败状态都带有一个`StateReason`可以告诉你原因的。下表列出了公交车经过的状态以及在每个状态下可以执行的操作。
| 州 | 公共汽车如何到达那里 | 您能做什么 |
| --- | --- | --- |
| CREATING | CreateEventBus已返回，公交车正在设置中。 | 描述并等待。您无法发布、更新或删除总线，也无法在其上创建订阅者或事件源。 |
| ACTIVE | 创建或更新已完成。 | 一切：发布、创建订阅者和事件源、更新、共享、删除。 |
| CREATE\_FAILED | 创建失败，当 EventBridge 无法使用您命名的 Amazon KMS 密钥时会发生这种情况。 | 删除公交车。其他任何东西都不被接受。读取StateReason、修复密钥或其策略，然后重新创建总线。 |
| UPDATING | UpdateEventBus正在更改加密配置。其他更新不会经过此状态。 | 照常发布和交付。在总线返回之前，您无法更新或删除该总线ACTIVE。 |
| UPDATE\_FAILED | 加密更新失败，同样是因为 EventBridge 无法使用密钥。 | 总线以其先前的配置继续运行。修复原因后重试更新，或删除总线。 |
| DELETING | DeleteEventBus已返回。 | 等待。您无法在正在删除的总线上创建订阅者或事件源。 |
| DELETE\_FAILED | 删除后发现的订阅者或事件源未被撤销。 | 删除或撤消总线的订阅者和事件源后，再次删除该总线。其他任何东西都不被接受。 |
## 删除有订阅者的巴士
`DeleteEventBus`仅当总线上的所有订阅者和事件源都被删除或撤销时才会成功。另一个账户创建的订阅者很重要。您无法自己删除该账户的订阅者，因此要么要求所有者将其删除，要么使用以下方式撤销该账户`RevokeResource`；请参阅[撤销订阅者或事件源](eb-custom-bus-access-revoke.md)。如果在您检查和删除之间创建了订阅者，则总线会登陆`DELETE_FAILED`；处理新订阅者并再次删除。
## 从失败的密钥更改中恢复
正在运行的总线可以到达的两个故障状态都来自 Amazon KMS 密钥。当对新密钥的更新失败时，请在修复密钥的政策或授权`UpdateEventBus`后重试。如果新密钥本身不可用，则重试可以命名其他密钥，因为 EventBridge 没有采用失效的密钥。在`DescribeEventBus`显示`ACTIVE`带有新密钥 EventBridge的总线之前，不要禁用、删除或移除对先前密钥的访问权限；在更改中途丢失旧密钥的总线只能通过恢复该密钥进行修复，或将其删除。有关密钥权限，请参阅[Amazon EventBridge 自定义事件总线的静态加密](eb-custom-bus-encryption.md)。