设置 EventBridge 为 HealthOmics EventBridge 中的事件 HealthOmics 事件消息结构事件消息示例

EventBridge 与一起使用 AWS HealthOmics

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

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

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

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

监控用户何时与您共享资源或撤消共享。
监控运行是失败还是成功完成。

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

设置 EventBridge 为 HealthOmics

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

配置 EventBridge 总线

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

打开 EventBridge 控制台:https://console.aws.amazon.com/events/.
在左侧导航栏中，选择活动总线。
选择 Create event bus (创建事件总线)。
在创建事件总线表单中，输入总线的名称。
选择 “创建” 以创建总线。

创建 EventBridge 规则

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

打开 EventBridge 控制台:https://console.aws.amazon.com/events/.
在左侧导航窗格中，选择 Rules。
选择 Create rule（创建规则）。控制台打开 “创建规则” 表单。
在定义规则详细信息中，提供规则的名称。
- 在 “名称” 中，输入总线的名称。
- 对于事件总线，选择此规则的总线。
- 选择下一步。
在构建事件模式中，在事件源下选择 AWS 事件或 EventBridge 合作伙伴事件。
向下滚动到事件模式。
1. 对于事件源，选择 AWS 服务。
2. 对于 AWS 服务，在文本筛选器中输入 omics，然后选择AWS HealthOmics作为服务。
3. 对于事件类型，选择感兴趣的事件（或所有事件）。
4. 选择下一步。
在选择目标中，为事件选择一个目标。例如，选择 AWS 服务，选择CloudWatch 日志组，然后配置日志组。

对于许多目标类型， EventBridge 需要权限将事件发送到目标。控制台会为您创建这些权限。
（可选）在配置标签中，将标签与规则关联。
在查看和更新中，查看配置并选择创建规则。

EventBridge 中的事件 HealthOmics

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

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

事件消息结构

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

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

CloudTrail 日志

问题排查