共享 HealthOmics 工作流程 - AWS HealthOmics
订阅共享工作流程 监控工作流程共享的状态使用控制台共享私有工作流程使用 CLI 共享私有工作流程使用控制台接受共享工作流程使用控制台运行共享工作流程使用 API 运行共享工作流程

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

共享 HealthOmics 工作流程

作为私有工作流程的所有者，您可以与同一地区的人共享该工作流程。 AWS 账户 要与多个工作流程共享一个工作流程 AWS 账户，可以为同一个工作流程创建多个共享。

作为所有者，您可以通过删除共享来撤消对共享工作流程的访问权限。

注意

HealthOmics 在订阅者账户中运行工作流程时，自动允许共享工作流程访问 Amazon ECR 存储库。您无需为共享工作流程授予额外的存储库访问权限。

当您共享工作流程时，订阅者可以使用任何工作流程版本。如果您需要共享工作流程的版本级访问控制，我们建议您创建单独的工作流程，而不是使用工作流程版本。

订阅共享工作流程

要订阅共享工作流程，请按照以下总体步骤接受和使用该工作流程：

  1. 使用控制台或 API 接受共享。将您当前的区域设置为与共享请求相同的区域。

    • 要在控制台中查找共享请求，请导航至所有资源共享页面，然后选择与我共享选项卡。

  2. 使用控制台或 API 为共享工作流程创建运行。

    • 要在控制台中找到工作流程详细信息页面，请导航到 “与我共享”（请参阅步骤 1），然后选择共享工作流程的资源链接。

  3. 您可以为工作流程提供自己的输入数据。

  4. 共享工作流程在您的中运行 AWS 账户。

作为共享工作流程的订阅者，系统会阻止您执行以下工作流程操作：

  • 导出共享工作流程

  • 重新运行共享工作流程

    • 您可以为共享工作流程创建新的运行。

  • 重新共享工作流程。

  • 为工作流程分配标签。

  • 删除工作流程。

    • 当您不再需要该工作流程时，可以删除工作流程共享。

有关资源共享中的跨账户资源共享 AWS HealthOmics的更多信息，请参阅。

监控工作流程共享的状态

HealthOmics 工作流共享 EventBridge 的每一次状态更改都会向发送一个事件。如果您想接收有关特定状态更改的通知，请设置一条 EventBridge 规则来监控 Workflow 共享状态更改事件。例如：

  • 每次收到工作流程共享请求以及用户撤消工作流程共享时，您都希望收到通知。

  • 在您发起工作流程共享请求后，您希望在用户接受或拒绝请求时收到通知。

有关使用事件的详细信息，请参阅 EventBridge 与一起使用 AWS HealthOmics。

使用控制台共享私有工作流程

在控制台中，您可以与工作流程所在区域 AWS 账户 的共享私有工作流程。

共享私有工作流程

  1. 打开 HealthOmics 管理控制台。

  2. 在左侧导航窗格中，选择私有工作流程。

  3. 在 “私有工作流程” 页面的 “工作流程” 表格中，选择要共享的工作流程，然后选择 “共享”。

  4. 在共享工作流程页面的共享详细信息面板中，输入共享的描述性名称，然后输入订阅 AWS 账户 者的名称。

  5. 选择共享资源。控制台在所有资源共享页面中显示资源共享。

该份额的初始状态为待定。订阅者接受共享后，状态变为活跃。

使用 CLI 共享私有工作流程

使用创建共享 API 操作创建工作流程共享。主要订阅 AWS 账户 者是将获得工作流程访问权限的用户。

aws omics create-share \
  --resource-arn "arn:aws:omics:us-west-2:555555555555:workflow/123456" \
  --principal-subscriber "123456789012" \
  --name "my_Share-123"

如果创建成功，您将收到包含共享 ID 和状态的响应。

{
"shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a",
"name": "my_Share-123",
"status": "PENDING"
}

在订阅者使用 accept-share API 操作接受共享之前，共享将保持待处理状态。

中的跨账户资源共享 AWS HealthOmics有关其他 API 用法示例，请参阅。

使用控制台接受共享工作流程

您可以使用控制台接受提供的工作流程共享。确保将控制台设置为与工作流程相同的区域。

  1. 打开 HealthOmics 管理控制台。

  2. 在左侧导航窗格中，选择所有资源共享，然后选择与我共享选项卡。

  3. 从 “与我共享的资源” 表格中，选择工作流程共享，然后选择 “接受”。

接受工作流程后，选择共享工作流的资源链接以查看其详细信息。

使用控制台运行共享工作流程

接受工作流程共享后，您可以开始运行该工作流程。

  1. 打开 HealthOmics 管理控制台。

  2. 在左侧导航窗格中，选择所有资源共享，然后选择与我共享选项卡。

  3. 从 “与我共享的资源” 表中，选择共享工作流程的资源链接。

  4. 在工作流程详细信息页面中，选择创建运行。

    控制台打开 “创建运行” 页面，其中预先填充了工作流程类型（共享）和工作流程 ID。

  5. 在 “创建运行” 表单中配置其余字段。有关更多信息，请参阅 使用控制台开始运行。

使用 API 运行共享工作流程

使用 get-workflow 检索共享工作流程的 ARN。

aws omics get-workflow --id 1234567 \
--workflow-owner-id 55555555555

运行工作流程时，请提供工作流程所有者的 AWS 账户 ID 和共享工作流程的 ARN。

aws omics start-run --id 1234567 --workflow-owner-id 55555555555 \
--role-arn arn:aws:iam::1234567892012:role/service-role/OmicsWorkflow-20221004T164236 \
--name ArchiveTest --retention-mode REMOVE