

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Creación de un autobús

Se crea un autobús con`CreateEventBus`, por ejemplo`aws 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` informa`ACTIVE`.

## Crear un autobús con el AWS CLI
<a name="eb-custom-bus-create-cli"></a>

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.

```bash
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](#eb-custom-bus-create-retention). | 
| --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. [Cifrado inactivo para Amazon EventBridge Custom Event Bus](eb-custom-bus-encryption.md) | 
| --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, consulte[Claves de acciones, recursos y condiciones del bus de eventos personalizado](eb-custom-bus-access-actions.md). | 

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.

```json
{
    "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`

```bash
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, consulte[Creación de recursos de Event Bus personalizados con CloudFormation](eb-custom-bus-cloudformation.md). Para conocer las acciones de IAM que requieren la creación y descripción de un bus, consulte[Claves de acciones, recursos y condiciones del bus de eventos personalizado](eb-custom-bus-access-actions.md).

## Elegir el período de retención
<a name="eb-custom-bus-create-retention"></a>

Un autobús conserva todos los eventos que acepta durante el número de días que dura`StorageConfiguration.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 con`UpdateEventBus`.

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

`DescribeEventBus`devuelve`RetentionWindowStartTime`, el punto más antiguo desde el que un suscriptor puede leer. Para enviar los eventos retenidos a un suscriptor, consulte[Reproducción de eventos retenidos para un suscriptor](eb-custom-bus-replay.md).

## Los estados de los buses y lo que permite cada uno
<a name="eb-custom-bus-lifecycle-states"></a>

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
<a name="eb-custom-bus-lifecycle-delete"></a>

`DeleteEventBus`solo 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 cuenta`RevokeResource`; consulta[Revocación de un suscriptor o una fuente de eventos](eb-custom-bus-access-revoke.md). Si se crea un suscriptor entre la fecha de verificación y la fecha de borrado, el bus llega`DELETE_FAILED`; trata con el nuevo suscriptor y vuelve a eliminarlo.

## Recuperándose de un cambio de clave fallido
<a name="eb-custom-bus-lifecycle-key"></a>

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. [Cifrado inactivo para Amazon EventBridge Custom Event Bus](eb-custom-bus-encryption.md)