

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

# Image Builder リソースを と共有する AWS RAM
<a name="manage-shared-resources"></a>

EC2 Image Builder は AWS Resource Access Manager (AWS RAM) と統合されるため、以下のタイプの Image Builder リソースを AWS アカウント または を通じて共有できます AWS Organizations。
+ コンポーネント
+ イメージ
+ recipe

を介してリソースを共有するには AWS RAM、リソース共有を作成する必要があります。リソース共有は共有するリソースと、それらを共有するコンシューマーを指定します。コンシューマーは、個人 AWS アカウント、組織単位、または組織全体にすることができます AWS Organizations。次の一覧は、共有先として指定できるアカウントと組織のタイプが含まれています。
+ の組織 AWS アカウント 内外に固有 AWS Organizations。
+  AWS Organizationsの組織内の組織単位 (OU)。
+  AWS Organizationsの組織全体。
+ AWS Organizations または組織外の OUs。

このモデルでは、リソースを所有 AWS アカウント する (所有者) は、同じリージョン内の他の AWS アカウント または を介して AWS Organizations (コンシューマー) リソースを共有します。共有リソースが更新されると、コンシューマーはそれらの更新を自動的に取得します。

**注記**  
共有コンポーネント、イメージ、およびイメージレシピは、所有者のみが対応するリソース制限にカウントされます。共有されたリソースがコンシューマーのリソース制限に影響することはありません。

**Topics**
+ [リソース所有者](#share-ib-resources-owners)
+ [リソースコンシューマー](#share-ib-resources-comsumers)
+ [Image Builder AWS RAM リソースのリソース共有を作成する](manage-shared-resources-share.md)
+ [から Image Builder リソースの共有を解除する AWS RAM](manage-shared-resources-unshare.md)

## リソース所有者
<a name="share-ib-resources-owners"></a>

Image Builder リソースは、作成された AWS リージョン でのみ共有できます。これらのリソースを共有する際、リージョン間でレプリケートされません。

自分が所有していて共有できる Image Builder リソースの一覧を取得するには、コンソールで所有権フィルターを指定するか、または AWS CLIでコマンドを実行するときに指定します。
+ [Image Builder コンポーネントの一覧表示](component-details.md#list-components)
+ [イメージを一覧表示する](image-details-list.md#list-images)
+ [イメージレシピの詳細を一覧と詳細表示](image-recipe-details.md)
+ [コンテナレシピ詳細の一覧表示](container-recipe-details.md)

詳細については AWS RAM、[https://docs.aws.amazon.com/ram/latest/userguide/what-is.html](https://docs.aws.amazon.com/ram/latest/userguide/what-is.html)」を参照してください。

### Image Builder リソースを共有するための前提条件
<a name="share-ib-resources-prereqs"></a>

コンポーネント、イメージ、レシピなどの Image Builder リソースを共有するには、次の前提条件が満たされている必要があります。
+ は、共有する Image Builder リソースを所有している AWS アカウント 必要があります。自身が共有を受けているリソースを他者に共有することはできません。
+ 暗号化されたリソースに関連付けられた AWS Key Management Service (AWS KMS) キーは、ターゲットアカウント、組織、または OUs と明示的に共有する必要があります。
+ を使用して Image Builder リソースを AWS Organizations および OUsと共有するには AWS RAM、共有を有効にする必要があります。詳細については、「AWS RAM ユーザーガイド」の「[Enable Sharing with AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html)」を参照してください。
+ で暗号化されたイメージを異なるリージョンのアカウント AWS KMS 間で配布する場合は、各ターゲットリージョンに KMS キーとエイリアスを作成する必要があります。さらに、それらのリージョンでインスタンスを起動するユーザーは、キーポリシーで指定された KMS キーにアクセスする必要があります。

Image Builder がパイプラインビルドから作成する以下のリソースは、Image Builder リソースとは見なされません。むしろ、Image Builder がアカウント、およびディストリビューション設定で指定したアカウント、アカウント、組織 AWS リージョン、または組織単位 (OUs) に配布する外部リソースです。
+ Amazon マシンイメージ (AMI)
+ Amazon ECR にあるコンテナイメージ

AMI ディストリビューション設定の詳細については、「[AMI ディストリビューション設定の作成と更新](cr-upd-ami-distribution-settings.md)」を参照してください。Amazon ECR にあるコンテナイメージのディストリビューション設定の詳細については、「[コンテナイメージのディストリビューション設定を作成および更新する](cr-upd-container-distribution-settings.md)」を参照してください。

 AWS Organizations および OUs[「組織または OUs](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/share-amis-with-organizations-and-OUs.html)」を参照してください。 

## リソースコンシューマー
<a name="share-ib-resources-comsumers"></a>

コンシューマーは共有リソースを使用できますが、どのような方法でも変更することはできません。コンシューマーは、Image Builder レシピを作成するときに、共有イメージをベースイメージとして指定したり、共有コンポーネントを追加したりできます。また、Image Builder イメージパイプラインを作成するときや、 AWS CLIで **create-image** コマンドを使用するときに、共有レシピを指定することもできます。

の組織に属していて AWS Organizations、組織内での共有が有効になっている場合、組織内のコンシューマーには共有リソースへのアクセスが自動的に付与されます。これに該当しない場合、コンシューマーはリソースへの参加の招待を受け取り、その招待を受け入れた後で、リソースの共有に対するアクセス許可が付与されます。