翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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
```