Utilizzo EventBridge con AWS HealthOmics - AWS HealthOmics
Configurato EventBridge per HealthOmicsEventBridge eventi in HealthOmicsStruttura del messaggio di eventoEsempi di messaggi di evento

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

Utilizzo EventBridge con AWS HealthOmics

HealthOmics invia eventi ad Amazon EventBridge quando le risorse cambiano di stato. Le risorse includono lavori di importazione, processi di esportazione, condivisioni di risorse, flussi di lavoro, attività ed esecuzioni. Per ogni tipo di risorsa, esiste un elenco di modifiche di stato che generano un evento.

Un bus di eventi è un router che riceve eventi e li consegna alle destinazioni. Il tuo account include un bus di eventi predefinito che riceve automaticamente gli eventi dai AWS servizi. È possibile creare bus di eventi personalizzati aggiuntivi.

È possibile creare EventBridge regole per specificare le azioni da intraprendere quando il bus degli eventi riceve eventi. Ad esempio, è possibile creare una regola che notifichi le modifiche allo 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 controllare se un'esecuzione fallisce o viene completata correttamente.

Per ulteriori informazioni sull'utilizzo EventBridge, consulta What is Amazon EventBridge?

Configurato 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 eventi predefinito per il proprio bus eventi Account AWS o configurarne uno personalizzato. Per configurare un bus di eventi personalizzato, segui questi passaggi:

  1. Apri la EventBridge console: https://console.aws.amazon.com/events/.

  2. Nella barra di navigazione a sinistra, scegli Event bus.

  3. Scegliere Create event bus (Crea bus di eventi).

  4. Nel modulo Crea bus per eventi, inserisci un nome per il bus.

  5. Scegliete 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.

  1. Apri la EventBridge console: https://console.aws.amazon.com/events/.

  2. Nel riquadro di navigazione di sinistra seleziona Rules (Regole).

  3. Scegli Crea regola. La console apre il modulo Crea regola.

  4. 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 Next (Successivo).

  5. In Build event pattern, in Event source seleziona Eventi AWS o eventi EventBridge partner.

  6. Scorri verso il basso fino a Event pattern.

    1. Per Event source, seleziona i servizi AWS.

    2. Per il servizio AWS, inserisci omics nel filtro di testo e seleziona AWS HealthOmicscome servizio.

    3. Per Tipo di evento seleziona l'evento di interesse (o Tutti gli eventi).

    4. Scegli Next (Successivo).

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

  8. (Facoltativo) In Configura tag, associa i tag alla regola.

  9. In Rivedi e aggiorna, esamina la configurazione e scegli Crea regola.

EventBridge eventi in HealthOmics

La tabella seguente elenca gli eventi a EventBridge cui HealthOmics viene inviato 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 di Annotation Store Share In sospeso, in corso di attivazione, attivo, in eliminazione, eliminato, non riuscito
Modifica dello stato di Annotation Store Creazione, creazione, aggiornamento, aggiornamento, eliminazione, eliminazione o creazione non riuscita
Modifica dello stato del processo di lettura Set Activation Inviato, in corso, completato, non riuscito o completato con errori
Leggi la modifica dello stato di Set Export Job Inviato, in corso, completato, non riuscito o completato con errori
Leggi la modifica dello stato del processo di importazione Inviato, in corso, completato, non riuscito o completato con errori
Leggi Imposta modifica dello stato Elaborazione del caricamento, caricamento non riuscito, attivo, archiviato, in corso di attivazione o eliminato
Modifica dello stato di Reference Import Job Inviato, in corso, completato, non riuscito o completato con errori
Modifica dello stato di riferimento Attivo o eliminato
Modifica dello stato del Reference Store Creato, aggiornato, attivo o eliminato
Esegui la modifica dello stato In sospeso, avviato, in esecuzione, interrotto, completato, eliminato, non riuscito o annullato
Modifica dello stato di Sequence Store Creato, aggiornato, attivo o eliminato
Modifica dello stato dell'attività In sospeso, avviato, in esecuzione, interrotto, completato, eliminato, non riuscito o annullato
Modifica dello stato del processo di importazione delle varianti Inviato, in corso, annullato, completato, non riuscito o completato con errori
Modifica dello stato di Variant Store Share In sospeso, in corso di attivazione, attivo, in eliminazione, eliminato, non riuscito
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, attivo, in eliminazione, eliminato, non riuscito
Modifica dello stato del flusso di lavoro Creazione riuscita, creazione non riuscita, eliminazione riuscita o eliminazione non riuscita

Struttura del messaggio di evento

HealthOmics fornisce il massimo impegno nella consegna a cui inviare messaggi relativi agli eventi di modifica dello stato 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 parte Regione AWS del bucket.

  • resources— Un array JSON che contiene l'Amazon Resource Name (ARN) del bucket.

  • detail— Un oggetto JSON che contiene informazioni sull'evento.

Gli eventi Run includono i seguenti campi:

  • uuid— L'identificatore universalmente univoco 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 di esecuzione.

  • runName— Nome della corsa.

  • runOutputUri— L'URI in cui la corsa 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 relativo a 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 relativo alla modifica dello stato di un 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 relativo a una 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"
    }
}