Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Creazione di un bus
Si crea un autobus con`CreateEventBus`, ad esempio`aws eventsv2 create-event-bus --name orders`. Il nome è l'unico parametro obbligatorio. Al momento della creazione puoi anche impostare una descrizione, il numero di giorni in cui il bus conserva gli eventi, la AWS KMS chiave che li crittografa e i tag. La chiamata ritorna immediatamente con l'autobus nello `CREATING` stato; una volta effettuata la segnalazione, pubblicala sul bus o crea un abbonato su di esso. `DescribeEventBus` `ACTIVE`
## Creazione di un bus con AWS CLI
Il comando seguente crea un bus denominato `orders` che conserva gli eventi per 30 giorni, li crittografa con la tua AWS KMS chiave e contiene un 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
```
La tabella seguente elenca ciò che ogni parametro accetta.
| Parametro | Cosa accetta |
| --- | --- |
| --name | Obbligatorio. Da 1 a 256 caratteri: lettere, cifre, punti, trattini e trattini bassi, che iniziano con una lettera o una cifra. Il nome deve essere univoco nel tuo account nella Regione; la creazione di un secondo bus con lo stesso nome non riesce. ResourceAlreadyExistsException |
| --description | Fino a 512 caratteri. |
| --storage-configuration | RetentionPeriodInDays, da 1 a 365. Omettilo e l'autobus conserverà gli eventi per 1 giorno. Puoi modificare il periodo in un secondo momento con. UpdateEventBus Consulta [Scelta del periodo di conservazione](#eb-custom-bus-create-retention). |
| --encryption-configuration | KmsKeyIdentifier: un ID chiave, un ARN chiave, un nome alias o un ARN alias di una AWS KMS chiave gestita dal cliente. Omettilo e EventBridge crittografa gli eventi con una chiave di proprietà. AWS Per la politica chiave di cui ha bisogno la chiave, vedere. [Crittografia degli eventi su un bus di eventi personalizzato](eb-custom-bus-encryption.md) |
| --tags | Una mappa delle chiavi dei tag in base ai valori, ad esempioteam=orders,env=prod. Per il controllo degli accessi basato su tag, vedere[Azioni, risorse e chiavi di condizione per il Custom Event Bus](eb-custom-bus-access-actions.md). |
La risposta restituisce l'ARN del bus, utilizzato da ogni successiva chiamata sul bus. L'ARN termina con un identificatore che viene EventBridge generato, quindi non è possibile ricavarlo dal 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"
}
```
Descrivi l'autobus in base al suo ARN fino allo s. `State` `ACTIVE`
```
aws eventsv2 describe-event-bus \
--event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef
```
Per creare un bus con CloudFormation instead, vedi[Creazione di risorse Event Bus personalizzate con CloudFormation](eb-custom-bus-cloudformation.md). Per le azioni IAM richieste per la creazione e la descrizione di un bus, vedi[Azioni, risorse e chiavi di condizione per il Custom Event Bus](eb-custom-bus-access-actions.md).
## Scelta del periodo di conservazione
Un autobus conserva tutti gli eventi che accetta per un numero di giorni compreso tra 1 e 365; se lo ometti`StorageConfiguration.RetentionPeriodInDays`, l'autobus conserva gli eventi per 1 giorno. La fidelizzazione è ciò che consente a un abbonato di ricominciare da un punto passato, mettere in pausa e riprendere senza perdere gli eventi e leggerli nuovamente dopo un errore. Un periodo più lungo costa più spazio di archiviazione. Puoi modificare il periodo in un secondo momento con`UpdateEventBus`.
```
aws eventsv2 create-event-bus \
--name orders \
--storage-configuration RetentionPeriodInDays=30
```
`DescribeEventBus`restituisce`RetentionWindowStartTime`, il primo punto da cui un abbonato può leggere. Per inviare eventi conservati a un abbonato, consulta. [Riproduzione degli eventi conservati a un abbonato](eb-custom-bus-replay.md)
## Stati degli autobus e cosa ciascuno consente
La creazione, l'aggiornamento e l'eliminazione di un bus sono asincroni. Ogni stato diverso da quello `ACTIVE` rifiuta alcune operazioni e i tre stati falliti hanno una `StateReason` dicitura che ne spiega il motivo. La tabella seguente elenca gli stati attraverso i quali si muove un bus e cosa è possibile fare in ciascuno di essi.
| Stato | Come arriva l'autobus | Cosa puoi fare |
| --- | --- | --- |
| CREATING | CreateEventBusè tornato e l'autobus è in fase di configurazione. | Descrivi e aspetta. Non è possibile pubblicare, aggiornare o eliminare il bus né creare un abbonato o una fonte di eventi su di esso. |
| ACTIVE | La creazione o l'aggiornamento sono terminati. | Tutto: pubblica, crea iscritti e fonti di eventi, aggiorna, condividi, elimina. |
| CREATE\_FAILED | Creazione non riuscita, cosa che accade quando EventBridge non è possibile utilizzare la AWS KMS chiave che hai nominato. | Elimina il bus. Nient'altro è accettato. LeggiStateReason, correggi la chiave o la relativa politica e crea nuovamente il bus. |
| UPDATING | UpdateEventBussta modificando la configurazione di crittografia. Gli altri aggiornamenti non superano questo stato. | Pubblica e distribuisci normalmente. Non è possibile aggiornare o eliminare il bus finché non ritorna aACTIVE. |
| UPDATE\_FAILED | Un aggiornamento della crittografia non è riuscito, anche in questo caso perché non è EventBridge stato possibile utilizzare la chiave. | Il bus continua a funzionare con la configurazione precedente. Riprova l'aggiornamento dopo aver risolto la causa o elimina il bus. |
| DELETING | DeleteEventBusrestituito. | Attesa. Non è possibile creare un abbonato o una fonte di eventi su un bus che viene eliminato. |
| DELETE\_FAILED | L'eliminazione ha rilevato un abbonato o una fonte di eventi che non è stata revocata. | Elimina nuovamente il bus dopo l'eliminazione o la revoca dei relativi abbonati e delle sorgenti di eventi. Nient'altro è accettato. |
## Eliminazione di un autobus con abbonati
`DeleteEventBus`ha esito positivo solo quando tutti gli abbonati e le sorgenti di eventi presenti sul bus vengono eliminati o revocati. Conta un abbonato creato da un altro account. Non puoi eliminare tu stesso l'abbonato di quell'account, quindi chiedi al proprietario di eliminarlo o revocarlo con; vedi. `RevokeResource` [Revoca di un abbonato o di una fonte di eventi](eb-custom-bus-access-revoke.md) Se tra la verifica e l'eliminazione viene creato un abbonato, il bus atterra`DELETE_FAILED`; gestisci il nuovo abbonato ed elimina nuovamente.
## Recupero da una modifica della chiave non riuscita
Entrambi gli stati falliti raggiungibili da un autobus in corsa provengono dalla AWS KMS chiave. Quando l'aggiornamento di una nuova chiave non riesce, riprova `UpdateEventBus` dopo aver corretto la politica o la concessione della chiave. Se la nuova chiave è di per sé inutilizzabile, il nuovo tentativo può assegnare un nome a una chiave diversa, poiché non è stata adottata la chiave EventBridge non riuscita. Non disattivate, eliminate o rimuovete EventBridge l'accesso alla chiave precedente finché non `DescribeEventBus` viene visualizzato il bus `ACTIVE` con la nuova chiave; un bus che perde la vecchia chiave durante una modifica può essere riparato solo ripristinando quella chiave o eliminato. Per le autorizzazioni chiave, vedere. [Crittografia degli eventi su un bus di eventi personalizzato](eb-custom-bus-encryption.md)