Creazione di un bus

Si crea un autobus conCreateEventBus, ad esempioaws 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.
--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
--tags	Una mappa delle chiavi dei tag in base ai valori, ad esempioteam=orders,env=prod. Per il controllo degli accessi basato su tag, vedereAzioni, risorse e chiavi di condizione per il Custom Event Bus.

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, vediCreazione di risorse Event Bus personalizzate con CloudFormation. Per le azioni IAM richieste per la creazione e la descrizione di un bus, vediAzioni, risorse e chiavi di condizione per il Custom Event Bus.

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 omettiStorageConfiguration.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 conUpdateEventBus.

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

DescribeEventBusrestituisceRetentionWindowStartTime, il primo punto da cui un abbonato può leggere. Per inviare eventi conservati a un abbonato, consulta. Riproduzione degli eventi conservati a un abbonato

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

DeleteEventBusha 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 Se tra la verifica e l'eliminazione viene creato un abbonato, il bus atterraDELETE_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