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