共用 HealthOmics 工作流程 - AWS HealthOmics
訂閱共用工作流程 監控工作流程共享的狀態使用主控台共用私有工作流程使用 CLI 共用私有工作流程使用主控台接受共用工作流程使用主控台執行共用工作流程使用 API 執行共用工作流程

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

共用 HealthOmics 工作流程

身為私有工作流程的擁有者，您可以與相同 AWS 帳戶 區域中的 共用工作流程。若要與多個工作流程共用 AWS 帳戶，您可以建立相同工作流程的多個共用。

身為擁有者，您可以透過刪除共用來撤銷對共用工作流程的存取。

注意

HealthOmics 會自動允許共用工作流程在訂閱者帳戶中執行工作流程時存取 Amazon ECR 儲存庫。您不需要為共用工作流程授予其他儲存庫存取權。

當您共用工作流程時，訂閱者可以使用任何工作流程版本。如果您需要共用工作流程的版本層級存取控制，建議您建立單獨的工作流程，而不是使用工作流程版本。

訂閱共用工作流程

若要訂閱共用工作流程，請遵循這些整體步驟來接受和使用工作流程：

  1. 使用 主控台或 API 來接受共享。將您目前的區域設定為與共享請求相同的區域。

    • 若要在主控台中尋找共用請求，請導覽至所有資源共用頁面，然後選擇與我共用索引標籤。

  2. 使用 主控台或 API 為共用工作流程建立執行。

    • 若要在主控台中尋找工作流程詳細資訊頁面，請導覽至與我共用 （請參閱步驟 1)，然後選擇共用工作流程的資源連結。

  3. 您可以為工作流程提供自己的輸入資料。

  4. 共用工作流程會在您的 中執行 AWS 帳戶。

身為共用工作流程的訂閱者，系統會阻止您執行下列工作流程動作：

  • 匯出共用工作流程

  • 重新執行共用工作流程

    • 您可以為共用工作流程建立新的執行。

  • 重新共用工作流程。

  • 將標籤指派給工作流程。

  • 刪除工作流程。

    • 當您不再需要工作流程時，您會刪除工作流程共享。

如需資源共用的其他資訊中的跨帳戶資源共用 AWS HealthOmics，請參閱 。

監控工作流程共享的狀態

HealthOmics 會針對工作流程共享的每個狀態變更，將事件傳送至 EventBridge。如果您想要接收特定狀態變更的通知，請設定 EventBridge 規則來監控工作流程共用狀態變更事件。例如：

  • 您希望每次收到工作流程共享請求，以及每次使用者撤銷工作流程共享時收到通知。

  • 啟動工作流程共享請求後，您希望在使用者接受或拒絕請求時收到通知。

如需使用事件的詳細資訊，請參閱 搭配 使用 EventBridge AWS HealthOmics。

使用主控台共用私有工作流程

從 主控台，您可以與 AWS 帳戶 與工作流程位於相同區域中的 共用私有工作流程。

共用私有工作流程

  1. 開啟 HealthOmics 主控台。

  2. 在左側導覽窗格中，選擇私有工作流程。

  3. 從私有工作流程頁面上的工作流程表格中，選取要共用的工作流程，然後選擇共用。

  4. 在共享工作流程頁面的共享詳細資訊面板中，輸入共享 AWS 帳戶 的描述性名稱，然後輸入訂閱者的 。

  5. 選擇共用資源。主控台會在所有資源共用頁面中顯示資源共用。

共享的初始狀態為待定。訂閱者接受共享後，狀態會變更為作用中。

使用 CLI 共用私有工作流程

使用 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，請參閱 。

使用主控台接受共用工作流程

您可以使用 主控台來接受提供的工作流程共享。請務必將主控台設定為與工作流程相同的區域。

  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