本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 共用 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 規則來監控**工作流程共用狀態變更**事件。例如：
+ 您希望每次收到工作流程共享請求，以及每次使用者撤銷工作流程共享時收到通知。
+ 啟動工作流程共享請求後，您希望在使用者接受或拒絕請求時收到通知。

如需使用事件的詳細資訊，請參閱 [搭配 使用 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>

使用 **create-share** 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 操作接受為止。

如需其他 API 使用範例[中的跨帳戶資源共用 AWS HealthOmics](resource-sharing.md)，請參閱 。

## 使用主控台接受共用工作流程
<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
```