Criando um ônibus

Você cria um ônibus comCreateEventBus, por exemploaws eventsv2 create-event-bus --name orders. O nome é o único parâmetro obrigatório. Na criação, você também pode definir uma descrição, o número de dias em que o ônibus retém os eventos, a AWS KMS chave que os criptografa e as tags. A ligação retorna imediatamente com o ônibus no CREATING estado; publique no ônibus ou crie um assinante nele assim que DescribeEventBus ACTIVE reportar.

Criando um ônibus com o AWS CLI

O comando a seguir cria um barramento chamado orders que retém os eventos por 30 dias, os criptografa com sua AWS KMS chave e carrega uma tag.

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

A tabela a seguir lista o que cada parâmetro aceita.

Parâmetro	O que ele aceita
--name	Obrigatório. 1 a 256 caracteres: letras, dígitos, pontos, hífens e sublinhados, começando com uma letra ou dígito. O nome deve ser exclusivo em sua conta na região; a criação de um segundo ônibus com o mesmo nome falha comResourceAlreadyExistsException.
--description	Até 512 caracteres.
--storage-configuration	RetentionPeriodInDays, de 1 a 365. Omita e o ônibus retém os eventos por 1 dia. Você pode alterar o período posteriormente comUpdateEventBus. Consulte Escolhendo o período de retenção.
--encryption-configuration	KmsKeyIdentifier: um ID de chave, ARN de chave, nome de alias ou ARN de alias de uma AWS KMS chave gerenciada pelo cliente. Omita-o e EventBridge criptografa eventos com uma chave AWS própria. Para a política chave, as principais necessidades, consulteCriptografando eventos em um barramento de eventos personalizado.
--tags	Um mapa de chaves de tags para valores, por exemploteam=orders,env=prod. Para controle de acesso baseado em tags, consulteAções, recursos e chaves de condição para o Custom Event Bus.

A resposta retorna o ARN do barramento, que toda chamada posterior no ônibus usa. O ARN termina em um identificador que é EventBridge gerado, então você não pode construí-lo a partir do nome.

{
    "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"
}

Descreva o ônibus por seu ARN até que State sejaACTIVE.

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

Para criar um barramento com o CloudFormation Instead, consulteCriação de recursos personalizados do Event Bus com CloudFormation. Para as ações do IAM que a criação e a descrição de um barramento exigem, consulteAções, recursos e chaves de condição para o Custom Event Bus.

Escolhendo o período de retenção

Um ônibus retém todos os eventos que aceita pelo número de diasStorageConfiguration.RetentionPeriodInDays, de 1 a 365; omita-o e o ônibus retém os eventos por 1 dia. A retenção é o que permite que um assinante comece de um ponto no passado, faça uma pausa e continue sem perder eventos e leia os eventos novamente após uma falha. Um período mais longo custa mais armazenamento. Você pode alterar o período posteriormente comUpdateEventBus.

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

DescribeEventBusretornaRetentionWindowStartTime, o primeiro ponto a partir do qual um assinante pode ler. Para entregar eventos retidos a um assinante, consulte. Reproduzir eventos retidos para um assinante

Estados dos ônibus e o que cada um permite

Criar, atualizar e excluir um barramento é assíncrono. Cada estado, exceto ACTIVE recusa algumas operações, e os três estados fracassados têm uma indicação StateReason do porquê. A tabela a seguir lista os estados pelos quais um ônibus se move e o que você pode fazer em cada um deles.

Estado	Como o ônibus chega lá	O que é possível fazer
CREATING	CreateEventBusretornou e o ônibus está sendo montado.	Descreva e espere. Você não pode publicar, atualizar ou excluir o barramento, nem criar um assinante ou uma fonte de eventos nele.
ACTIVE	A criação ou atualização foi concluída.	Tudo: publique, crie assinantes e fontes de eventos, atualize, compartilhe, exclua.
CREATE_FAILED	A criação falhou, o que acontece quando EventBridge não é possível usar a AWS KMS chave que você nomeou.	Exclua o ônibus. Nada mais é aceito. LeiaStateReason, corrija a chave ou sua política e crie o barramento novamente.
UPDATING	UpdateEventBusestá alterando a configuração de criptografia. Outras atualizações não passam por esse estado.	Publique e entregue normalmente. Você não pode atualizar ou excluir o ônibus até que ele retorne ACTIVE a.
UPDATE_FAILED	Uma atualização de criptografia falhou, novamente porque não EventBridge foi possível usar a chave.	O ônibus continua funcionando com sua configuração anterior. Tente atualizar novamente depois de corrigir a causa ou exclua o barramento.
DELETING	DeleteEventBusdevolvido.	Espere. Você não pode criar um assinante ou uma fonte de eventos em um barramento que está sendo excluído.
DELETE_FAILED	A exclusão encontrou um assinante ou uma fonte de evento que não foi revogada.	Exclua o ônibus novamente depois que seus assinantes e fontes de eventos forem excluídos ou revogados. Nada mais é aceito.

Excluindo um ônibus que tem assinantes

DeleteEventBussó é bem-sucedido quando cada assinante e cada fonte de evento no barramento é excluída ou revogada. Um assinante criado por outra conta conta. Você não pode excluir o assinante dessa conta sozinho, então peça ao proprietário para excluí-la ou revogá-la comRevokeResource; consulte. Revogar um assinante ou uma fonte de eventos Se um assinante for criado entre seu cheque e a exclusão, o ônibus chegaDELETE_FAILED; negocie com o novo assinante e exclua novamente.

Recuperando-se de uma falha na alteração de chave

Ambos os estados falhados que um ônibus em funcionamento pode alcançar vêm da AWS KMS chave. Quando a atualização de uma nova chave falhar, tente novamente UpdateEventBus depois de corrigir a política ou a concessão da chave. Se a nova chave em si não puder ser usada, a nova tentativa poderá nomear uma chave diferente, porque EventBridge não adotou a chave que falhou. Não desative, exclua ou remova EventBridge o acesso à chave anterior até DescribeEventBus mostrar o barramento ACTIVE com a nova chave; um barramento que perde sua chave antiga no meio de uma alteração só pode ser reparado restaurando essa chave ou excluído. Para obter as principais permissões, consulteCriptografando eventos em um barramento de eventos personalizado.