View a markdown version of this page

Pubblicazione di eventi su un Event Bus personalizzato - Amazon EventBridge

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à.

Pubblicazione di eventi su un Event Bus personalizzato

Si pubblicano eventi su un bus di eventi personalizzato con una delle due operazioni API, PutEvents oPutRawEvents. L'operazione scelta corregge la forma dell'evento consegnato e tale forma determina il modo in cui si scrive ogni filtro, trasformatore e parametro di destinazione per il bus. Scegli prima di scrivere al tuo primo abbonato. Per le due forme, vediStruttura degli eventi: dati, metadati e metadati di sistema.

Le due operazioni producono un tipo di evento e li EventBridge trattano in modo identico una volta che l'evento è sul bus. PutEventsè una comodità superataPutRawEvents: EventBridge prende i campi della voceSource, DetailTypeDetail, e altri campi, ne crea una busta JSON e la memorizza come payload JSON con un tipo di contenuto di. application/eventbridge+json Da quel momento in poi, il filtraggio, la trasformazione, l'ordinamento, la deduplicazione, la conservazione e la distribuzione funzionano esattamente come per un evento JSON pubblicato con. PutRawEvents L'unica differenza che un abbonato vede è dove si trovano i campi: nella parte superiore del modulo per e sotto all'interno della Data busta perPutRawEvents. Data.detail PutEvents Per i payload Avro, Protobuf e opaque, vedi. Tipi di contenuto supportati: JSON, Avro, Protobuf e byte raw

PutEvents PutRawEvents
Campo Payload Detail, una stringa JSON Data, byte in qualsiasi formato
Obbligatorio in ogni voce Source, DetailType Data, SystemMetadata.ContentType
Content-type Impostato da EventBridge a application/eventbridge+json Impostato da te: application/jsonapplication/avro,application/protobuf, oapplication/octet-stream. Consulta Tipi di contenuto supportati: JSON, Avro, Protobuf e byte raw.
I tuoi metadati Non disponibile Metadata, una mappa con un massimo di 100 chiavi
Ingressi per l'ordinazione e la deduplicazione SystemMetadata.EventGroupId, SystemMetadata.DeduplicationId Gli stessi due campi
Da usare quando I tuoi eventi sono in formato JSON e desideri la stessa busta prodotta da Custom Event Bus - Classic Il payload è binario o non JSON, sono necessarie le proprie chiavi di metadati o si desidera che il payload venga consegnato esattamente come inviato

Pubblica le API

Entrambe le operazioni richiedono un batch da 1 a 100 voci per richiesta e restituiscono un risultato per voce, nell'ordine delle richieste. EventBridge accetta o rifiuta ogni voce singolarmente: una voce respinta reca una ErrorCode e ErrorMessage al posto di una SuccessCode e le altre voci della stessa richiesta rimangono inalterate. Inserimenti in batch che appartengono l'uno all'altro e che leggono tutti i risultati anziché limitarsi allo stato HTTP; vedere. Leggendo la risposta Entrambe le chiamate attingono a un unico budget di pubblicazione per il tuo account e il bus stesso ha una quota di ingestione al secondo che conta ogni editore e fonte di eventi; vedi. Quote personalizzate per Event Bus

Pubblica un evento JSON con PutEvents

aws eventsv2 put-events \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --entries '[ { "Source": "com.example.orders", "DetailType": "OrderPlaced", "Detail": "{\"orderId\":\"1001\",\"total\":42.5}" } ]'

Pubblica un evento non elaborato con PutRawEvents

Dataè un campo binario. In AWS CLI, forniscilo come testo base64. L'esempio seguente pubblica lo stesso payload JSON come byte non elaborati con un tipo di contenuto di e aggiunge una chiave di application/json metadati.

aws eventsv2 put-raw-events \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --entries '[ { "Data": "eyJvcmRlcklkIjoiMTAwMSIsInRvdGFsIjo0Mi41fQ==", "Metadata": { "tenant": "acme" }, "SystemMetadata": { "ContentType": "application/json" } } ]'

Per pubblicare Avro o Protobuf, assegna un nome a un registro dello schema nella richiesta con. --schema-registry-configuration RegistryUriè un ARN del AWS Glue Schema Registry o un URL HTTPS di Confluent Cloud. Il nome di un registro viene effettuato su richiesta, non sul bus. Gli eventi con un tipo di contenuto non application/octet-stream necessitano di un registro, perché EventBridge non li decodifica.

Pubblicazione di byte non elaborati

Per pubblicare un payload che non EventBridge deve essere né analizzato né ispezionato, chiama PutRawEvents con i byte Base64-encoded inseriti e impostato su. Data SystemMetadata.ContentType application/octet-stream EventBridge archivia e consegna i byte esattamente come sono stati inviati, quindi un DATA filtro non può corrispondere ad essi; li indirizza con METADATA le chiavi che hai impostato nella voce o con. SYSTEM_METADATA Il trasformatore di un abbonato vede il payload come una stringa Base64 in ingresso. $events.Data Per le opzioni di consegna e l'alternativa deserializzata per Avro e Protobuf, vediTipi di contenuto supportati: JSON, Avro, Protobuf e byte raw; per come appare il payload a un trasformatore, vedi. Trasformare gli eventi con JSonata

Leggendo la risposta

Entrambe le operazioni restituiscono un risultato per ogni voce, nello stesso ordine della richiesta. Ogni risultato riporta una SuccessCode o una ErrorCode eErrorMessage. Controlla ogni voce, perché una richiesta può avere successo mentre le singole immissioni hanno esito negativo.

SuccessCodeè PUBLISHED oDEDUPLICATED. DEDUPLICATEDsignifica che EventBridge ha riconosciuto la voce come duplicato di un evento già accettato e non ne ha memorizzato una seconda copia. È un successo, non un errore. Per ulteriori informazioni, consulta Ordinamento e deduplicazione degli eventi su un bus di eventi personalizzato.

Una risposta pubblicata riporta che l'evento è EventBridge stato accettato. Non riporta la consegna. Per confermare l'arrivo di un evento, controlla l'obiettivo.

Questa sezione contiene i seguenti argomenti: