Creación de un autobús

Se crea un autobús conCreateEventBus, por ejemploaws eventsv2 create-event-bus --name orders. El nombre es el único parámetro obligatorio. Al crearlos, también puede establecer una descripción, el número de días que el bus retiene los eventos, la AWS KMS clave que los cifra y las etiquetas. La llamada se devuelve de inmediato cuando el autobús se encuentra en el CREATING estado; se publica en el autobús o se crea un suscriptor en él una vez que se DescribeEventBus informaACTIVE.

Crear un autobús con el AWS CLI

El siguiente comando crea un bus denominado orders que conserva los eventos durante 30 días, los cifra con su AWS KMS clave y lleva una etiqueta.

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

En la tabla siguiente se muestra lo que acepta cada parámetro.

Parámetro	Qué acepta
--name	Obligatorio. De 1 a 256 caracteres: letras, dígitos, puntos, guiones y guiones bajos, que comiencen por una letra o un dígito. El nombre debe ser único en tu cuenta de la región; no se puede crear un segundo autobús con el mismo nombre. ResourceAlreadyExistsException
--description	Hasta 512 caracteres.
--storage-configuration	RetentionPeriodInDays, de 1 a 365. Omítelo y el autobús retendrá los eventos durante 1 día. Puedes cambiar el período más adelante conUpdateEventBus. Consulte Elegir el período de retención.
--encryption-configuration	KmsKeyIdentifier: un identificador de clave, un ARN de clave, un nombre de alias o un ARN de alias de una clave gestionada por un AWS KMS cliente. Omitelo y EventBridge cifra los eventos con una clave propia. AWS Para ver la política de claves que necesita la clave, consulte. Cifrar eventos en un bus de eventos personalizado
--tags	Un mapa de las claves de las etiquetas a los valores, por ejemploteam=orders,env=prod. Para obtener información sobre el control de acceso basado en etiquetas, consulteAcciones, recursos y claves de condición para el bus de eventos personalizado.

La respuesta devuelve el ARN del bus, que utiliza cada llamada posterior del bus. El ARN termina en un identificador que se EventBridge genera, por lo que no se puede construir a partir del nombre.

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

Describa el bus por su ARN hasta que State sea. ACTIVE

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

Para crear un bus con CloudFormation instead, consulteCreación de recursos de Event Bus personalizados con CloudFormation. Para conocer las acciones de IAM que requieren la creación y descripción de un bus, consulteAcciones, recursos y claves de condición para el bus de eventos personalizado.

Elegir el período de retención

Un autobús conserva todos los eventos que acepta durante el número de días que duraStorageConfiguration.RetentionPeriodInDays, de 1 a 365; si lo omite, el autobús conservará los eventos durante 1 día. La retención es lo que permite a un suscriptor empezar desde un punto del pasado, pausar y reanudar sin perder eventos y volver a leer los eventos después de un error. Un período más largo cuesta más almacenamiento. Puedes cambiar el período más adelante conUpdateEventBus.

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

DescribeEventBusdevuelveRetentionWindowStartTime, el punto más antiguo desde el que un suscriptor puede leer. Para enviar los eventos retenidos a un suscriptor, consulteReproducción de eventos retenidos para un suscriptor.

Los estados de los buses y lo que permite cada uno

La creación, actualización y eliminación de un bus son asincrónicas. Todos los estados excepto ACTIVE rechazan algunas operaciones, y los tres estados fallidos llevan una StateReason que indica el motivo. En la siguiente tabla se enumeran los estados por los que pasa un autobús y lo que puede hacer en cada uno de ellos.

Estado	Cómo llega el autobús hasta allí	Qué puede hacer
CREATING	CreateEventBusregresó y el autobús se está montando.	Describa y espere. No puede publicar, actualizar ni eliminar el bus, ni crear una fuente de suscriptores o eventos en él.
ACTIVE	La creación o la actualización han finalizado.	Todo: publicar, crear suscriptores y fuentes de eventos, actualizar, compartir, eliminar.
CREATE_FAILED	La creación falló, lo que ocurre cuando EventBridge no puede usar la AWS KMS clave que ha nombrado.	Elimina el bus. No se acepta nada más. LeaStateReason, corrija la clave o su política y vuelva a crear el bus.
UPDATING	UpdateEventBusestá cambiando la configuración de cifrado. Otras actualizaciones no pasan por este estado.	Publica y entrega de la forma habitual. No puede actualizar ni eliminar el autobús hasta que vuelva a funcionarACTIVE.
UPDATE_FAILED	Se produjo un error al actualizar el cifrado, una vez más porque no se EventBridge pudo usar la clave.	El bus sigue funcionando con su configuración anterior. Vuelva a intentar la actualización después de corregir la causa o eliminar el bus.
DELETING	DeleteEventBusdevuelto.	Espere. No puede crear un suscriptor o una fuente de eventos en un bus que se está eliminando.
DELETE_FAILED	La eliminación encontró un suscriptor o una fuente de eventos que no se ha revocado.	Vuelva a eliminar el bus después de eliminar o revocar sus suscriptores y fuentes de eventos. No se acepta nada más.

Eliminar un bus que tiene suscriptores

DeleteEventBussolo se realiza correctamente cuando se eliminan o revocan todos los suscriptores y fuentes de eventos del bus. Un suscriptor creado por otra cuenta cuenta. No puedes eliminar tú mismo al suscriptor de esa cuenta, así que pídele al propietario que la elimine o revoca la cuentaRevokeResource; consultaRevocación de un suscriptor o una fuente de eventos. Si se crea un suscriptor entre la fecha de verificación y la fecha de borrado, el bus llegaDELETE_FAILED; trata con el nuevo suscriptor y vuelve a eliminarlo.

Recuperándose de un cambio de clave fallido

Ambos estados fallidos a los que puede llegar un autobús en marcha provienen de la AWS KMS clave. Cuando se produzca un error al actualizar una clave nueva, vuelve a intentarlo UpdateEventBus después de corregir la política o la concesión de la clave. Si la nueva clave en sí misma no se puede utilizar, al volver a intentarlo se puede asignar un nombre a una clave diferente, ya que EventBridge no se adoptó la clave fallida. No deshabilite, borre ni elimine EventBridge el acceso a la clave anterior hasta que DescribeEventBus aparezca el bus ACTIVE con la nueva clave; un bus que pierde su clave antigua a mitad de camino debido a un cambio solo puede repararse restaurando esa clave o eliminándose. Para ver los permisos de las claves, consulte. Cifrar eventos en un bus de eventos personalizado