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à.
Usare EventBridge con AWS HealthOmics
HealthOmics invia eventi ad Amazon EventBridge quando le risorse cambiano stato. Le risorse includono processi di importazione, processi di esportazione, condivisioni di risorse, flussi di lavoro, attività ed esecuzioni. Per ogni tipo di risorsa, è disponibile un elenco di modifiche allo stato che generano un evento.
Un bus di eventi è un router che riceve eventi e li invia alle destinazioni. L'account include un bus di eventi predefinito che riceve automaticamente gli eventi dai AWS servizi. È possibile creare bus di eventi personalizzati aggiuntivi.
Si creano EventBridge regole per specificare le azioni da intraprendere quando il bus degli eventi riceve degli eventi. Ad esempio, è possibile creare una regola che notifica le modifiche di stato di una risorsa.
Gli scenari più comuni per l'utilizzo degli eventi includono:
-
Per monitorare quando un utente condivide una risorsa con te o revoca la condivisione.
-
Per monitorare se un'esecuzione fallisce o viene completata correttamente.
Per ulteriori informazioni sull'utilizzo EventBridge, consulta Cos'è Amazon EventBridge?
Argomenti
Configurare EventBridge per HealthOmics
Prima di poter monitorare gli EventBridge eventi, crea un EventBridge bus e crea regole per gli eventi di interesse.
Configura un EventBridge bus
È possibile utilizzare il bus di eventi predefinito per il proprio bus di eventi Account AWS o configurare un bus di eventi personalizzato. Per configurare un bus di eventi personalizzato, segui questi passaggi:
-
Apri la EventBridge console: https://console.aws.amazon.com/events/
. -
Nella barra di navigazione a sinistra, scegli Event buses.
-
Scegliere Create event bus (Crea bus di eventi).
-
Nel modulo Crea bus per eventi, inserisci un nome per l'autobus.
-
Scegli Crea per creare il bus.
Crea una EventBridge regola
La procedura seguente mostra come creare una regola semplice. Per ulteriori informazioni sulle regole, vedere Regole in EventBridge.
-
Apri la EventBridge console: https://console.aws.amazon.com/events/
. -
Nel riquadro di navigazione di sinistra seleziona Rules (Regole).
-
Scegli Crea regola. La console apre il modulo Crea regola.
-
In Definisci i dettagli della regola, fornisci un nome per la regola.
In Nome, inserisci un nome per il bus.
Per Event bus, seleziona il bus per questa regola.
Scegli Avanti.
-
In Build event pattern, in Event source seleziona AWS events o EventBridge partner events.
-
Scorri verso il basso fino a Event pattern.
-
Per Origine dell'evento, seleziona Servizi AWS.
-
Per il servizio AWS, inserisci omics nel filtro di testo e seleziona AWS HealthOmics come servizio.
-
Per Tipo di evento seleziona l'evento di interesse (o Tutti gli eventi).
-
Scegli Avanti.
-
-
In Seleziona obiettivi, seleziona un obiettivo per l'evento. Ad esempio, scegli il servizio AWS, il gruppo di CloudWatch log scelto e configura un gruppo di log.
Per molti tipi di target, EventBridge necessita dell'autorizzazione per l'invio degli eventi. La console crea queste autorizzazioni per te.
-
(Facoltativo) In Configure tags, associa i tag alla regola.
-
In Revisione e aggiornamento, rivedi la configurazione e scegli Crea regola.
EventBridge eventi in HealthOmics
La tabella seguente elenca gli eventi a EventBridge cui vengono HealthOmics inviati e l'elenco dei possibili valori di stato per l'evento.
| Nome evento | Valori di stato possibili |
|---|---|
| Modifica dello stato del processo di importazione delle annotazioni | Inviato, in corso, annullato, completato, non riuscito o completato con errori |
| Modifica dello stato della condivisione di Annotation Store | In sospeso, in fase di attivazione, attivo, in eliminazione, eliminato, non riuscito |
| Modifica dello stato di Annotation Store | Creazione, creazione, aggiornamento, aggiornamento, eliminazione, eliminazione o creazione non riuscita |
| Leggi Imposta modifica dello stato del processo di attivazione | Inviato, in corso, completato, non riuscito o completato con errori |
| Leggi Imposta modifica dello stato del lavoro di esportazione | Inviato, in corso, completato, non riuscito o completato con errori |
| Leggi Imposta modifica dello stato del processo di importazione | Inviato, in corso, completato, non riuscito o completato con errori |
| Leggi Set Status Change | Elaborazione del caricamento, caricamento non riuscito, attivo, archiviato, in fase di attivazione o eliminato |
| Modifica dello stato del processo di importazione di riferimento | Inviato, in corso, completato, non riuscito o completato con errori |
| Modifica dello stato di riferimento | Attivo o eliminato |
| Modifica dello stato del negozio di riferimento | Creato, aggiornato, attivo o eliminato |
| Esegui modifica dello stato | In sospeso, in avvio, in esecuzione, in arresto, completato, eliminato, fallito o annullato |
| Modifica dello stato di Sequence Store | Creato, aggiornato, attivo o eliminato |
| Modifica dello stato dell'attività | In sospeso, in avvio, in esecuzione, in arresto, completato, eliminato, fallito o annullato |
| Modifica dello stato del processo di importazione della variante | Inviato, in corso, annullato, completato, non riuscito o completato con errori |
| Modifica dello stato di Variant Store Share | In sospeso, in fase di attivazione, attiva, in eliminazione, eliminata, non riuscita |
| Modifica dello stato del Variant Store | Creazione, creazione, aggiornamento, aggiornamento, eliminazione, eliminazione o creazione non riuscita |
| Modifica dello stato di condivisione del flusso di lavoro | In sospeso, in fase di attivazione, attiva, in eliminazione, eliminata, non riuscita |
| Modifica dello stato del flusso di lavoro | Creazione riuscita, creazione fallita, eliminazione riuscita o eliminazione fallita |
Struttura del messaggio di evento
HealthOmics fornisce la soluzione ottimale per inviare messaggi relativi agli eventi di modifica dello stato a. EventBridge L'evento è un oggetto con struttura JSON che contiene anche dettagli sui metadati. È possibile utilizzare i metadati come input per ricreare l'evento o per ottenere ulteriori informazioni. Gli eventi includono i seguenti campi:
-
version— Attualmente 0 (zero) per tutti gli eventi. -
id— Un UUID della versione 4 generato per ogni evento. -
detail-type— Il tipo di evento che viene inviato. -
account— L' Account AWS ID a 12 cifre del proprietario del bucket. -
source— Identifica il servizio che ha generato l'evento. -
time— L'ora in cui si è verificato l'evento. -
region— Identifica la data Regione AWS del secchio. -
resources— Un array JSON che contiene l'Amazon Resource Name (ARN) del bucket. -
detail— Un oggetto JSON che contiene informazioni sull'evento.
Gli eventi di esecuzione includono i seguenti campi:
-
uuid— L'identificatore univoco universale per la corsa. -
workflowId— Identificatore del flusso di lavoro associato a questa esecuzione. -
workflowName— Nome del flusso di lavoro associato a questa esecuzione.. -
runId— Identificatore dell'esecuzione. -
runName— Nome della corsa. -
runOutputUri— L'URI in cui l'esecuzione scriverà i dati di output.
Esempi di messaggi di evento
L'esempio seguente è un evento per una modifica dello stato di esecuzione, che mostra i campi aggiuntivi.
{ "version":"0", "id":"c0e540f4-df38-b986-86c1-3e3730f971fe", "detail-type":"Run Status Change", "source":"aws.omics", "account":"123456789012", "time":"2022-10-20T22:07:35Z", "region":"us-west-2", "resources":[ "arn:aws:omics:us-west-2:123456789012:run/2101313" ], "detail":{ "omicsVersion":"1.0.0", "arn":"arn:aws:omics:us-west-2:123456789012:run/2101313", "status":"COMPLETED", "uuid":"153893cd-097a-40ec-aec7-838a97cd2b21", "runId": "1234567", "runName": "run name", "runOutputUri": "s3://amzn-s3-demo-bucket/run-output/2101313", "workflowId": "1234567", "workflowName": "workflow name" } }
L'esempio seguente è un evento per una modifica dello stato dell'attività.
{ "version": "0", "id": "718d6817-c868-26d3-8ef0-0dc9b2ac73f4", "detail-type": "Task Status Change", "source": "aws.omics", "account": "123456789012", "time": "2024-10-30T09:05:44Z", "region": "us-west-2", "resources": ["arn:aws:omics:us-west-2:123456789012:task/8888888"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-west-2:123456789012:task/8888888", "status": "COMPLETED", "runArn": "arn:aws:omics:us-west-2:123456789012:run/2101313", "runUuid": "153893cd-097a-40ec-aec7-838a97cd2b21", "runId": "1234567", "runName": "run name", "workflowId": "1234567", "workflowName": "workflow name" } }
Di seguito è riportato un esempio di evento per una modifica dello stato del set di lettura.
{ "version": "0", "id": "64ca0eda-9751-dc55-c41a-1bd50b4fc9b7", "detail-type": "Read Set Status Change", "source": "aws.omics", "account": "123456789012", "time": "2023-04-04T17:53:06Z", "region": "us-west-2", "resources": ["arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012", "sequenceStoreId" : "1234567890", "id": "3456789012", "status": "PROCESSING_UPLOAD" } }
Un evento simile viene creato per un processo di importazione di un negozio di varianti.
{ "version": "0", "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type": "Variant Store Status Change", "source": "aws.omics", "account": "123456789012", "time": "2015-12-22T18:43:48Z", "region": "us-east-1", "resources": ["arn:aws:omics:us-east-1:123456789012:myvariantstore2"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-east-1:123456789012:myvariantstore2", "status": "CREATED", "storeId": "6710c5f02610", "storeName": "myvariantstore2" } }
Di seguito è riportato un evento per la modifica dello stato del processo di importazione.
{ "version": "0", "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type": "Variant Import Job Status Change", "source": "aws.omics", "account": "123456789012", "time": "2015-12-22T18:43:48Z", "region": "us-east-1", "resources": ["arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9", "status": "COMPLETED", "jobId": "b64ea9a3-459f-4b68-92c3-3ddb83209fe9", "storeId": "a74869f91e20", "storeName": "my_variant_store" } }