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

# 共享 HealthOmics 工作流程
<a name="sharing-workflows"></a>

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

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

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

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

**Topics**
+ [订阅共享工作流程](#shared-workflow-subscribe)
+ [监控工作流程共享的状态](#shared-workflow-monitor)
+ [使用控制台共享私有工作流程](#shared-workflow-create-console)
+ [使用 CLI 共享私有工作流程](#shared-workflow-create-api)
+ [使用控制台接受共享工作流程](#shared-workflow-accept-console)
+ [使用控制台运行共享工作流程](#shared-workflow-using-console)
+ [使用 API 运行共享工作流程](#shared-workflow-using-api)

## 订阅共享工作流程
<a name="shared-workflow-subscribe"></a>

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

1. 使用控制台或 API 接受共享。将您当前的区域设置为与共享请求相同的区域。
   + 要在控制台中查找共享请求，请导航至**所有资源共享**页面，然后选择**与我共享**选项卡。

1. 使用控制台或 API 为共享工作流程创建运行。
   + 要在控制台中找到工作流程详细信息页面，请导航到 “**与我共享**”（请参阅步骤 1），然后选择共享工作流程的**资源链接**。

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

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

作为共享工作流程的订阅者，系统会阻止您执行以下工作流程操作：
+ 导出共享工作流程 
+ 重新运行共享工作流程 
  + 您可以为共享工作流程创建新的运行。
+ 重新共享工作流程。
+ 为工作流程分配标签。
+ 删除工作流程。
  + 当您不再需要该工作流程时，可以删除工作流程共享。

有关资源共享[中的跨账户资源共享 AWS HealthOmics](resource-sharing.md)的更多信息，请参阅。

## 监控工作流程共享的状态
<a name="shared-workflow-monitor"></a>

HealthOmics 工作流共享 EventBridge 的每一次状态更改都会向发送一个事件。如果您想接收有关特定状态更改的通知，请设置一条 EventBridge 规则来监控 **Workflow 共享状态更改**事件。例如：
+ 每次收到工作流程共享请求以及用户撤消工作流程共享时，您都希望收到通知。
+ 在您发起工作流程共享请求后，您希望在用户接受或拒绝请求时收到通知。

有关使用事件的详细信息，请参阅[EventBridge 与一起使用 AWS HealthOmics](eventbridge.md)。

## 使用控制台共享私有工作流程
<a name="shared-workflow-create-console"></a>

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

**共享私有工作流程**

1. 打开 [HealthOmics 控制台](https://console.aws.amazon.com/omics/)。

1.  如果需要，请打开左侧导航窗格 (►)。选择**私有工作流程**。

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

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

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

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

## 使用 CLI 共享私有工作流程
<a name="shared-workflow-create-api"></a>

使用**创建共享** 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](resource-sharing.md)有关其他 API 用法示例，请参阅。

## 使用控制台接受共享工作流程
<a name="shared-workflow-accept-console"></a>

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

1. 打开 [HealthOmics 控制台](https://console.aws.amazon.com/omics/)。

1.  如果需要，请打开左侧导航窗格 (►)。选择 “**所有资源共享**”，然后选择 “**与我共享**” 选项卡。

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

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

## 使用控制台运行共享工作流程
<a name="shared-workflow-using-console"></a>

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

1. 打开 [HealthOmics 控制台](https://console.aws.amazon.com/omics/)。

1.  如果需要，请打开左侧导航窗格 (►)。选择 “**所有资源共享**”，然后选择 “**与我共享**” 选项卡。

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

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

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

1. 在 “**创建运行**” 表单中配置其余字段。有关更多信息，请参阅 [使用控制台开始运行](starting-a-run.md#starting-a-run-console)。

## 使用 API 运行共享工作流程
<a name="shared-workflow-using-api"></a>

使用 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
```