View a markdown version of this page

Verwenden EventBridge mit AWS HealthOmics - AWS HealthOmics
Eingerichtet EventBridge für HealthOmicsEventBridge Ereignisse in HealthOmicsStruktur von EreignismeldungenBeispiele für Event-Meldungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden EventBridge mit AWS HealthOmics

HealthOmics sendet Ereignisse an Amazon, EventBridge wenn sich der Status von Ressourcen ändert. Zu den Ressourcen gehören Importaufträge, Exportaufträge, gemeinsam genutzte Ressourcen, Workflows, Aufgaben und Ausführungen. Für jeden Ressourcentyp gibt es eine Liste von Statusänderungen, die ein Ereignis auslösen.

Ein Event-Bus ist ein Router, der Ereignisse empfängt und sie an Ziele weiterleitet. Ihr Konto beinhaltet einen Standard-Event-Bus, der automatisch Ereignisse von AWS Diensten empfängt. Sie können zusätzliche benutzerdefinierte Event-Busse erstellen.

Sie erstellen EventBridge Regeln, um die Aktionen festzulegen, die ausgeführt werden sollen, wenn der Event-Bus Ereignisse empfängt. Sie können beispielsweise eine Regel erstellen, die Sie über Statusänderungen für eine Ressource informiert.

Zu den gängigen Szenarien für die Verwendung von Ereignissen gehören:

  • Um zu überwachen, wann ein Benutzer eine Ressource mit Ihnen teilt oder die gemeinsame Nutzung widerruft.

  • Um zu überwachen, ob ein Lauf fehlschlägt oder erfolgreich abgeschlossen wird.

Weitere Informationen zur Verwendung EventBridge finden Sie unter Was ist Amazon EventBridge?

Eingerichtet EventBridge für HealthOmics

Bevor Sie nach EventBridge Ereignissen suchen können, erstellen Sie einen EventBridge Bus und Regeln für die Ereignisse, die Sie interessieren.

Konfigurieren Sie einen EventBridge Bus

Sie können den Standard-Event-Bus für Ihren verwenden AWS-Konto oder einen benutzerdefinierten Event-Bus konfigurieren. Gehen Sie folgendermaßen vor, um einen benutzerdefinierten Event-Bus zu konfigurieren:

  1. Öffnen Sie die EventBridge Konsole: https://console.aws.amazon.com/events/.

  2. Wählen Sie in der linken Navigationsleiste Event-Busse aus.

  3. Wählen Sie Event Bus erstellen aus.

  4. Geben Sie im Formular Eventbus erstellen einen Namen für den Bus ein.

  5. Wählen Sie Erstellen, um den Bus zu erstellen.

Erstellen Sie eine EventBridge Regel

Das folgende Verfahren zeigt, wie Sie eine einfache Regel erstellen. Weitere Informationen zu Regeln finden Sie unter Regeln in EventBridge.

  1. Öffnen Sie die EventBridge Konsole: https://console.aws.amazon.com/events/.

  2. Klicken Sie im linken Navigationsbereich auf die Option Regeln.

  3. Wählen Sie Regel erstellen aus. Die Konsole öffnet das Formular Regel erstellen.

  4. Geben Sie unter Regeldetails definieren einen Namen für die Regel ein.

    • Geben Sie unter Name einen Namen für den Bus ein.

    • Wählen Sie für Event-Bus den Bus für diese Regel aus.

    • Wählen Sie Weiter aus.

  5. Wählen Sie unter Eventmuster erstellen unter Eventquelle die Option AWS-Ereignisse oder EventBridge Partnerereignisse aus.

  6. Scrollen Sie nach unten zu Event-Muster.

    1. Wählen Sie als Eventquelle die Option AWS-Services aus.

    2. Geben Sie für den AWS-Service omics in den Textfilter ein und wählen Sie AWS HealthOmics als Service aus.

    3. Wählen Sie als Ereignistyp das Ereignis aus, das Sie interessiert (oder Alle Ereignisse).

    4. Wählen Sie Weiter aus.

  7. Wählen Sie unter Ziel (e) auswählen ein Ziel für das Ereignis aus. Wählen Sie beispielsweise den AWS-Service und die gewählte CloudWatch Protokollgruppe aus und konfigurieren Sie eine Protokollgruppe.

    Für viele Zieltypen benötigt EventBridge die Berechtigung zum Senden von Ereignissen an das Ziel. Die Konsole erstellt diese Berechtigungen für Sie.

  8. (Optional) Ordnen Sie der Regel unter Tags konfigurieren Stichwörter zu.

  9. Überprüfen Sie unter Überprüfen und aktualisieren die Konfiguration und wählen Sie Regel erstellen aus.

EventBridge Ereignisse in HealthOmics

In der folgenden Tabelle sind die Ereignisse aufgeführt, an die HealthOmics gesendet wird EventBridge, und die Liste der möglichen Statuswerte für das Ereignis.

Ereignisname Mögliche Statuswerte
Änderung des Jobstatus beim Import von Anmerkungen Übermittelt, in Bearbeitung, storniert, abgeschlossen, fehlgeschlagen oder mit Fehlern abgeschlossen
Statusänderung im Annotationsspeicher teilen Ausstehend, aktivierend, aktiv, löschend, gelöscht, fehlgeschlagen
Statusänderung des Annotationsspeichers Das Erstellen, Erstellen, Aktualisieren, Aktualisieren, Löschen, Löschen, Löschen oder Erstellen ist fehlgeschlagen
Lesen Sie die Statusänderung des Aktivierungsauftrags festlegen Übermittelt, in Bearbeitung, abgeschlossen, fehlgeschlagen oder mit Fehlern abgeschlossen
Lesen Sie „Statusänderung des Exportauftrags festlegen“ Übermittelt, in Bearbeitung, abgeschlossen, fehlgeschlagen oder mit Fehlern abgeschlossen
Lesen Sie „Statusänderung des Importauftrags festlegen“ Übermittelt, in Bearbeitung, abgeschlossen, fehlgeschlagen oder mit Fehlern abgeschlossen
Lesen Sie „Statusänderung festlegen“ Upload wird verarbeitet, Upload ist fehlgeschlagen, aktiv, archiviert, aktiviert oder gelöscht
Änderung des Status des Referenzimportauftrags Übermittelt, in Bearbeitung, abgeschlossen, fehlgeschlagen oder mit Fehlern abgeschlossen
Änderung des Referenzstatus Aktiv oder gelöscht
Änderung des Status des Referenzspeichers Erstellt, aktualisiert, aktiv oder gelöscht
Statusänderung ausführen Ausstehend, wird gestartet, läuft, wird gestoppt, abgeschlossen, gelöscht, fehlgeschlagen oder abgebrochen
Änderung des Sequenzspeicher-Status Erstellt, aktualisiert, aktiv oder gelöscht
Änderung des Aufgabenstatus Ausstehend, wird gestartet, ausgeführt, gestoppt, abgeschlossen, gelöscht, fehlgeschlagen oder abgebrochen
Variantenimport, Änderung des Auftragsstatus Übermittelt, in Bearbeitung, storniert, abgeschlossen, fehlgeschlagen oder mit Fehlern abgeschlossen
Änderung des Status von Variant Store Share Ausstehend, aktivierend, aktiv, löschend, gelöscht, fehlgeschlagen
Änderung des Status des Variantenspeichers Das Erstellen, Erstellen, Aktualisieren, Aktualisieren, Löschen, Löschen, Löschen oder Erstellen ist fehlgeschlagen
Status der Workflow-Freigabe ändern Ausstehend, aktivierend, aktiv, löschend, gelöscht, fehlgeschlagen
Änderung des Workflow-Status Erfolgreiche Erstellung, Fehler bei der Erstellung, erfolgreicher Löschvorgang oder fehlgeschlagener Löschvorgang

Struktur von Ereignismeldungen

HealthOmics bietet eine optimale Übermittlung, an die Meldungen zu Zustandsänderungsereignissen gesendet werden können EventBridge. Das Ereignis ist ein Objekt mit JSON-Struktur, das auch Metadatendetails enthält. Sie können die Metadaten als Eingabe verwenden, um entweder das Ereignis neu zu erstellen oder um weitere Informationen zu erhalten. Ereignisse umfassen die folgenden Felder:

  • version— Derzeit 0 (Null) für alle Ereignisse.

  • id— Eine UUID der Version 4, die für jedes Ereignis generiert wird.

  • detail-type— Die Art des Ereignisses, das gesendet wird.

  • account— Die 12-stellige AWS-Konto ID des Bucket-Besitzers.

  • source— Identifiziert den Dienst, der das Ereignis generiert hat.

  • time— Die Uhrzeit, zu der das Ereignis eingetreten ist.

  • region— Identifiziert den AWS-Region Wert des Buckets.

  • resources— Ein JSON-Array, das den Amazon-Ressourcennamen (ARN) des Buckets enthält.

  • detail— Ein JSON-Objekt, das Informationen über das Ereignis enthält.

Run-Ereignisse enthalten die folgenden Felder:

  • uuid— Die allgemein eindeutige Kennung für den Lauf.

  • workflowId— Workflow-ID des Workflows, der mit diesem Lauf verknüpft ist.

  • workflowName— Name des Workflows, der mit diesem Lauf verknüpft ist.

  • runId— Lauf-ID.

  • runName— Name der Ausführung.

  • runOutputUri— Die URI, in die der Lauf seine Ausgabedaten schreibt.

Beispiele für Event-Meldungen

Das folgende Beispiel ist ein Ereignis für eine Änderung des Ausführungsstatus und zeigt die zusätzlichen Felder.

{
    "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"
    }  
}

Das folgende Beispiel ist ein Ereignis für eine Änderung des Aufgabenstatus.

{
    "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"
    }      
}

Das Folgende ist ein Beispiel für ein Ereignis bei einer Änderung des Readset-Status.

{
  "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"
  }
}

Ein ähnliches Ereignis wird für einen Variantenspeicher-Importauftrag erstellt.

{
    "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"
    }
}

Das Folgende ist ein Ereignis für eine Änderung des Importauftragsstatus.

{
    "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"
    }
}