기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 버스 생성
`CreateEventBus`예를 들어를 사용하여 버스를 생성합니다`aws eventsv2 create-event-bus --name orders`. 이름은 유일한 필수 파라미터입니다. 생성 시 설명, 버스가 이벤트를 보존하는 일수, 이벤트를 암호화하는 AWS KMS 키 및 태그를 설정할 수도 있습니다. 호출은 상태의 버스와 함께 한 번에 반환됩니다.가 `CREATING`를 `DescribeEventBus` 보고하면 버스에 게시하거나 구독자를 생성합니다`ACTIVE`.
## 를 사용하여 버스 생성 AWS CLI
다음 명령은 30일 동안 이벤트를 보존`orders`하고 키로 암호화 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. [보존 기간 선택](#eb-custom-bus-create-retention) 섹션을 참조하세요. |
| --encryption-configuration | KmsKeyIdentifier: AWS KMS 고객 관리형 키의 키 ID, 키 ARN, 별칭 이름 또는 별칭 ARN입니다. 이를 생략하고 EventBridge는 AWS 소유 키로 이벤트를 암호화합니다. 키에 필요한 키 정책은 섹션을 참조하세요[사용자 지정 이벤트 버스에서 이벤트 암호화](eb-custom-bus-encryption.md). |
| --tags | 와 같은 값에 대한 태그 키의 맵입니다team=orders,env=prod. 태그 기반 액세스 제어는 섹션을 참조하세요[사용자 지정 이벤트 버스에 사용되는 작업, 리소스 및 조건 키](eb-custom-bus-access-actions.md). |
응답은 버스에서 나중에 호출할 때마다 사용하는 버스 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"
}
```
`State`가가 될 때까지 버스를 ARN으로 설명합니다`ACTIVE`.
```
aws eventsv2 describe-event-bus \
--event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef
```
CloudFormation 대신를 사용하여 버스를 생성하려면 섹션을 참조하세요[를 사용하여 사용자 지정 이벤트 버스 리소스 생성 CloudFormation](eb-custom-bus-cloudformation.md). 버스 생성 및 설명에 필요한 IAM 작업은 섹션을 참조하세요[사용자 지정 이벤트 버스에 사용되는 작업, 리소스 및 조건 키](eb-custom-bus-access-actions.md).
## 보존 기간 선택
버스는에서 수락하는 모든 이벤트를 1`StorageConfiguration.RetentionPeriodInDays`\~365일 동안 유지합니다. 버스는 이를 생략하고 1일 동안 이벤트를 유지합니다. 보존은 구독자가 과거의 특정 시점부터 시작하고, 이벤트 손실 없이 일시 중지했다가 재개하고, 실패 후 이벤트를 다시 읽을 수 있도록 하는 것입니다. 기간이 길수록 스토리지 비용이 증가합니다. 나중에를 사용하여 기간을 변경할 수 있습니다`UpdateEventBus`.
```
aws eventsv2 create-event-bus \
--name orders \
--storage-configuration RetentionPeriodInDays=30
```
`DescribeEventBus`는 구독자가 읽을 수 있는 가장 빠른 지점`RetentionWindowStartTime`인를 반환합니다. 구독자에게 보관된 이벤트를 전달하려면 섹션을 참조하세요[구독자에게 보관된 이벤트 재생](eb-custom-bus-replay.md).
## 버스 상태 및 각 상태별 허용 사항
버스 생성, 업데이트 및 삭제는 비동기식입니다. 를 제외한 모든 상태는 일부 작업을 `ACTIVE` 거부하며, 세 개의 실패한 상태는 이유를 알려주`StateReason`는를 포함합니다. 다음 표에는 버스가 이동하는 상태와 각 상태에서 수행할 수 있는 작업이 나열되어 있습니다.
| State | 버스가 거기에 도달하는 방법 | 할 수 있는 작업 |
| --- | --- | --- |
| CREATING | CreateEventBus가 반환되고 버스가 설정 중입니다. | 설명 및 대기. 버스를 게시, 업데이트 또는 삭제하거나 버스에 구독자 또는 이벤트 소스를 생성할 수 없습니다. |
| ACTIVE | 생성 또는 업데이트가 완료되었습니다. | 모든 것: 게시, 구독자 및 이벤트 소스 생성, 업데이트, 공유, 삭제. |
| CREATE\_FAILED | EventBridge가 사용자가 지정한 AWS KMS 키를 사용할 수 없을 때 발생하는 생성에 실패했습니다. | 버스를 삭제합니다. 다른 어떤 것도 허용되지 않습니다. 를 읽고 키 또는 해당 정책을 StateReason수정한 다음 버스를 다시 생성합니다. |
| UPDATING | UpdateEventBus가 암호화 구성을 변경하고 있습니다. 다른 업데이트는이 상태를 통과하지 않습니다. | 정상적으로 게시하고 전송합니다. 버스는 로 반환될 때까지 업데이트하거나 삭제할 수 없습니다ACTIVE. |
| UPDATE\_FAILED | EventBridge가 키를 사용할 수 없기 때문에 암호화 업데이트가 다시 실패했습니다. | 버스는 이전 구성으로 계속 실행됩니다. 원인을 해결한 후 업데이트를 다시 시도하거나 버스를 삭제합니다. |
| DELETING | DeleteEventBus 반환됩니다. | 대기합니다. 삭제 중인 버스에는 구독자 또는 이벤트 소스를 생성할 수 없습니다. |
| DELETE\_FAILED | 삭제에서 취소되지 않은 구독자 또는 이벤트 소스를 찾았습니다. | 구독자 및 이벤트 소스가 삭제되거나 취소된 후 버스를 다시 삭제합니다. 다른 어떤 것도 허용되지 않습니다. |
## 구독자가 있는 버스 삭제
`DeleteEventBus`는 버스의 모든 구독자 및 이벤트 소스가 삭제되거나 취소된 경우에만 성공합니다. 다른 계정이 생성한 구독자는 계산됩니다. 해당 계정의 구독자는 직접 삭제할 수 없으므로 소유자에게 삭제하도록 요청하거나를 사용하여 취소합니다. `RevokeResource`섹션을 참조하세요[구독자 또는 이벤트 소스 취소](eb-custom-bus-access-revoke.md). 확인과 삭제 사이에 구독자가 생성되면 버스는에 도착합니다. 새 구독자를 `DELETE_FAILED`처리하고 다시 삭제합니다.
## 실패한 키 변경에서 복구
두 가지 실패 상태 모두 실행 중인 버스가 AWS KMS 키에서 도달할 수 있습니다. 새 키에 대한 업데이트가 실패하면 키의 정책 또는 권한 부여를 수정한 `UpdateEventBus` 후 다시 시도하세요. 새 키 자체를 사용할 수 없는 경우 EventBridge가 실패한 키를 채택하지 않았기 때문에 재시도 시 다른 키의 이름을 지정할 수 있습니다. 에 새 키`ACTIVE`가 있는 버스가 `DescribeEventBus` 표시될 때까지 이전 키에 대한 EventBridge의 액세스를 비활성화, 삭제 또는 제거하지 마십시오. 변경 사항을 통해 이전 키를 분실한 버스는 해당 키를 복원하거나 삭제할 때만 복구할 수 있습니다. 키 권한은 섹션을 참조하세요[사용자 지정 이벤트 버스에서 이벤트 암호화](eb-custom-bus-encryption.md).