EventBridge 与一起使用 AWS HealthOmics - AWS HealthOmics
设置 EventBridge 为 HealthOmicsEventBridge 中的事件 HealthOmics事件消息结构事件消息示例

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

EventBridge 与一起使用 AWS HealthOmics

HealthOmics EventBridge 当资源状态发生变化时，向 Amazon 发送事件。资源包括导入任务、导出任务、资源共享、工作流程、任务和运行。对于每种类型的资源，都有一个生成事件的状态更改列表。

事件总线是接收事件并将其传送到目的地的路由器。您的账户包含一个默认事件总线，该总线可自动接收来自 AWS 服务的事件。您可以创建其他自定义事件总线。

您可以创建 EventBridge 规则来指定事件总线接收事件时要采取的操作。例如，您可以创建一条规则，通知您有关资源状态变化的信息。

使用事件的常见场景包括：

  • 监控用户何时与您共享资源或撤消共享。

  • 监视运行是失败还是成功完成。

有关使用的更多信息 EventBridge，请参阅 Amazon 是什么 EventBridge？

设置 EventBridge 为 HealthOmics

在监控 EventBridge 事件之前，请先创建 EventBridge 总线并为感兴趣的事件创建规则。

配置总 EventBridge 线

您可以为自己使用默认事件总线， AWS 账户 也可以配置自定义事件总线。要配置自定义事件总线，请执行以下步骤：

  1. 打开 EventBridge 控制台:https://console.aws.amazon.com/events/.

  2. 在左侧导航栏中，选择事件总线。

  3. 选择 Create event bus (创建事件总线)。

  4. 在创建事件总线窗体中，输入总线的名称。

  5. 选择 “创建” 以创建总线。

创建 EventBridge 规则

以下过程说明如何创建简单规则。有关规则的更多信息，请参阅中的规则 EventBridge。

  1. 打开 EventBridge 控制台:https://console.aws.amazon.com/events/.

  2. 在左侧导航窗格中，选择 Rules。

  3. 选择创建规则。控制台打开 “创建规则” 表单。

  4. 在定义规则详细信息中，提供规则的名称。

    • 在名称中，输入总线的名称。

    • 对于事件总线，请为该规则选择总线。

    • 选择下一步。

  5. 在构建事件模式中，在事件源下选择 AWS 事件或 EventBridge 合作伙伴事件。

  6. 向下滚动到事件模式。

    1. 对于事件源，请选择 AWS 服务。

    2. 对于 AWS 服务，请在文本筛选器中输入 omics，然后选择AWS HealthOmics作为服务。

    3. 对于事件类型，选择感兴趣的事件（或所有事件）。

    4. 选择下一步。

  7. 在选择目标中，为事件选择一个目标。例如，选择 AWS 服务，选择CloudWatch 日志组，然后配置日志组。

    对于许多目标类型， EventBridge 需要权限将事件发送到目标。控制台会为您创建这些权限。

  8. （可选）在配置标签中，将标签与规则关联。

  9. 在查看和更新中，查看配置并选择创建规则。

EventBridge 中的事件 HealthOmics

下表列出了 HealthOmics 发送到 EventBridge的事件以及该事件的可能状态值列表。

事件名称 可能的状态值
注释导入 Job 状态更改 已提交、进行中、已取消、已完成、失败或已完成但失败
注释存储共享状态变更 待处理、激活、激活、删除、已删除、失败
注释存储状态变更 创建、创建、更新、更新、删除、删除或创建失败
已阅读 “设置激活 Job 状态更改” 已提交、进行中、已完成、失败或已完成但失败
已读取设置导出 Job 状态更改 已提交、进行中、已完成、失败或已完成但失败
读取设置导入 Job 状态更改 已提交、进行中、已完成、失败或已完成但失败
已阅读 “设置状态更改” 正在处理上传、上传失败、激活、已存档、激活或已删除
参考导入 Job 状态更改 已提交、进行中、已完成、失败或已完成但失败
参考状态变更 已激活或已删除
参考商店状态变更 已创建、更新、活动或已删除
运行状态更改 待处理、正在启动、正在运行、正在停止、已完成、已删除、失败或已取消
序列存储状态更改 已创建、更新、活动或已删除
任务状态更改 待处理、正在启动、正在运行、正在停止、已完成、已删除、失败或已取消
变体导入 Job 状态更改 已提交、进行中、已取消、已完成、失败或已完成但失败
变体商店共享状态变更 待处理、激活、激活、删除、已删除、失败
变体商店状态变更 创建、创建、更新、更新、删除、删除或创建失败
工作流程共享状态更改 待处理、激活、激活、删除、已删除、失败
工作流程状态变更 创建成功、创建失败、删除成功或删除失败

事件消息结构

HealthOmics 提供尽力交付以向其发送状态更改事件消息 EventBridge。该事件是一个具有 JSON 结构的对象，其中还包含元数据详细信息。您可以使用元数据作为输入来重新创建事件或了解更多信息。事件包括以下字段：

  • version— 目前所有事件均为 0（零）。

  • id— 为每个事件生成的版本 4 UUID。

  • detail-type— 正在发送的事件类型。

  • account— 存储桶所有者的 12 位 AWS 账户 ID。

  • source— 标识生成事件的服务。

  • time— 事件发生的时间。

  • region— 标 AWS 区域 识存储桶的。

  • resources— 包含存储桶的亚马逊资源名称 (ARN) 的 JSON 数组。

  • detail— 包含事件相关信息的 JSON 对象。

运行事件包括以下字段：

  • uuid— 运行的通用唯一标识符。

  • workflowId— 与此运行关联的工作流程的工作流程标识符。

  • workflowName— 与此运行关联的工作流程的名称。

  • runId— 运行标识符。

  • runName— 运行名称。

  • runOutputUri— 运行将写入其输出数据的 URI。

事件消息示例

以下示例是运行状态更改的事件，显示了其他字段。

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