翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

での EventBridge の使用 AWS HealthOmics

HealthOmics は、リソースのステータスが変更されたときに Amazon EventBridge にイベントを送信します。リソースには、インポートジョブ、エクスポートジョブ、リソース共有、ワークフロー、タスク、実行が含まれます。リソースのタイプごとに、イベントを生成するステータス変更のリストがあります。

イベントバスは、イベントを受信して送信先に配信するルーターです。アカウントには、 AWS サービスからイベントを自動的に受信するデフォルトのイベントバスが含まれています。追加のカスタムイベントバスを作成できます。

EventBridge ルールを作成して、イベントバスがイベントを受信したときに実行するアクションを指定します。たとえば、リソースのステータス変更を通知するルールを作成できます。

イベントを使用する一般的なシナリオは次のとおりです。

EventBridge の使用の詳細については、「Amazon EventBridge とは」を参照してください。

HealthOmics の EventBridge を設定する

EventBridge イベントをモニタリングする前に、EventBridge バスを作成し、目的のイベントのルールを作成します。

EventBridge バスを設定する

のデフォルトのイベントバスを使用する AWS アカウント か、カスタムイベントバスを設定できます。カスタムイベントバスを設定するには、次の手順に従います。

EventBridge ルールを作成します

次の手順は、シンプルなルールを作成する方法を示しています。ルールの詳細については、EventBridge のルール」を参照してください。

HealthOmics の EventBridge イベント

次の表に、HealthOmics が EventBridge に送信するイベントと、そのイベントで可能なステータス値のリストを示します。

イベントメッセージの構造

HealthOmics は、EventBridge に状態変更イベントメッセージを送信するためのベストエフォート配信を提供します。イベントは、メタデータの詳細も含めた JSON 構造を持つオブジェクトです。メタデータを入力として使用して、イベントを再作成したり、詳細を確認したりできます。イベントには次のフィールドが含まれます。

実行イベントには、次のフィールドが含まれます。

イベントメッセージの例

次の例は、実行ステータスの変更に関するイベントで、追加のフィールドを示しています。

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

次の例は、タスクステータスの変更のイベントです。

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

以下は、リードセットのステータス変更のイベントの例です。

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

バリアントストアのインポートジョブに同様のイベントが作成されます。

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

以下は、インポートジョブのステータスの変更に関するイベントです。

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