

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

# EventBridge Pipes からの CloudFormation テンプレートの生成
<a name="pipes-generate-template"></a>

AWS CloudFormation では、インフラストラクチャをコードとして扱うことで、アカウントとリージョン間で AWS リソースを一元的かつ反復可能な方法で設定および管理できます。CloudFormation では、これを実現するために、プロビジョニングおよび管理するリソースを定義するテンプレートを作成できます。**

EventBridge では、CloudFormation テンプレートの開発をすぐに開始するための補助として、アカウント内の既存のイベントバスからテンプレートを生成できます。1 つまたは複数のパイプを選択してテンプレートに含めることができます。次に、これらのテンプレートに基づいて CloudFormation で管理するリソースの[スタックを作成](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)できます。

CloudFormation の詳細については、[*「 CloudFormation ユーザーガイド*」を参照してください。](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)

イベントバスの場合、[イベントバス](eb-generate-event-bus-template.md)と[イベントバスルール](rule-generate-template.md)から CloudFormation テンプレートを生成できます。

## EventBridge Pipe テンプレートに含まれるリソース
<a name="pipes-generate-template-resources"></a>

が CloudFormation テンプレート EventBridge を生成すると、選択したパイプごとに [AWS::Pipes::Pipe](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-pipes-pipe.html) リソースが作成されます。さらに、 には、説明されている条件下で以下のリソース EventBridge が含まれます。
+ [AWS::Events::ApiDestination](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-apidestination.html)

  パイプに API デスティネーションがエンリッチメントまたはターゲットとして含まれている場合、EventBridge は、これらを AWS::Events::ApiDestination リソースとして CloudFormation テンプレートに含めます。
+ [AWS::Events::EventBus](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html)

  パイプにイベントバスがターゲットとして含まれている場合、EventBridge は、これを AAWS::Events::EventBus リソースとして CloudFormation テンプレートに含めます。
+ [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)

  [パイプの設定](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-pipes-create.html#pipes-configure-pipe-settings)時に新しい実行ロール EventBridge を作成した場合は、テンプレートにそのロールを EventBridge AWS::IAM::Role resource. EventBridge として含めることを選択できます。作成したロールは含まれません。(いずれの場合も、AWS::Pipes::Pipe リソースの `RoleArn` プロパティにはロールの ARN が含まれます。)

## EventBridge パイプから生成した CloudFormation テンプレートを使用する際の考慮事項
<a name="pipes-generate-template-considerations"></a>

EventBridge から生成した CloudFormation テンプレートを使用するときは、次の点を考慮してください。
+ EventBridge は、生成テンプレートにパスワードを含みません。

  テンプレートを編集して[テンプレートパラメータ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html)を含めると、ユーザーがテンプレートを使用して CloudFormation スタックを作成または更新するときに、パスワードやその他の機密情報を指定できるようになります。

  さらに、ユーザーは Secrets Manager を使用して目的のリージョンにシークレットを作成し、生成されたテンプレートを編集して[動的パラメーター](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager)を使用できます。
+ 生成したテンプレートのターゲットは、元のパイプで指定していたものと同じです。テンプレートを使用して他のリージョンにスタックを作成する前に、テンプレートを適切に編集しないと、リージョン間の問題が発生する可能性があります。

  また、生成したテンプレートでは、下流のターゲットが自動的には作成されません。

## EventBridge Pipes からの CloudFormation テンプレートの生成
<a name="pipes-generate-template-console"></a>

EventBridge コンソールを使用して 1 つ以上のパイプから CloudFormation テンプレートを生成するには、次の手順を実行します。

**1 つ以上のパイプから CloudFormation テンプレートを生成するには**

1. Amazon EventBridge コンソールの [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) を開いてください。

1. ナビゲーションペインで、**[パイプ]** を選択します。

1. **Pipes** で、生成された CloudFormation テンプレートに含めるパイプを 1 つ以上選択します。

   パイプが 1 つの場合は、パイプの詳細ページに表示するパイプ名を選択することもできます。

1. **[CloudFormation テンプレート]** を選択し、EventBridge でテンプレートを生成したいフォーマット (**JSON** または **YAML**) を選択します。

   EventBridge には、選択した形式で生成されたテンプレートが表示されます。

1. 選択したパイプのいずれかに新しい実行ロール EventBridge を作成し、それらのロール EventBridge をテンプレートに含める場合は、**ユーザーに代わってコンソールによって作成された IAM ロールを含める**を選択します。

1. EventBridge では、テンプレートファイルをダウンロードするか、テンプレートをクリップボードにコピーするかを選択できます。
   + テンプレートファイルをダウンロードするには、**[Download]** (ダウンロード) を選択します。
   + テンプレートをクリップボードにコピーするには、**[Copy]** (コピー) を選択します。

1. テンプレートを終了するには、**[Cancel]** (キャンセル) を選択します。