本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 从 Pi CloudFormation p EventBridge es 生成模板
<a name="pipes-generate-template"></a>

AWS CloudFormation 通过将基础设施视为代码，使您能够以集中且可重复的方式跨账户和区域配置和管理您的 AWS 资源。 CloudFormation 通过允许您创建*模板来实现此目的，模板*定义了您要配置和管理的资源。

EventBridge 允许您使用账户中的现有管道生成模板，以此来帮助您快速开始开发 CloudFormation 模板。您可以选择在模板中包含一条或多条管道。然后，您可以使用这些模板作为[创建 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 管道模板中包含的资源
<a name="pipes-generate-template-resources"></a>

 EventBridge 生成 CloudFormation 模板时，它会为每个选定的管道创建一个[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 目的地（无论是作为扩充还是目标），请将其作为 AWS::Events::ApiDestination资源 EventBridge包含在 CloudFormation 模板中。
+ [AWS::Events::EventBus](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html)

  如果您的管道包含事件总线作为目标，则将其作为 AWS::Events::EventBus 资源 EventBridge 包含在 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 创建了新的执行角色，则可以选择将该角色作为 AWS::IAM::Role 资源 EventBridge 包含在模板中。 EventBridge 不包括您创建的角色。（无论哪种情况， AWS::Pipes::Pipe 资源的`RoleArn`属性都包含角色的 ARN。）

## 使用从 EventBridge Pip CloudFormation es 生成的模板时的注意事项
<a name="pipes-generate-template-considerations"></a>

使用从中生成的 CloudFormation 模板时，请考虑以下因素 EventBridge：
+ 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)。
+ 生成的模板中的目标，与原始管道中指定的目标完全相同。如果在使用模板在其他区域创建堆栈之前，未对模板进行适当的编辑，可能会导致跨区域问题。

  此外，生成的模板不会自动创建下游目标。

## 从 Pi CloudFormation p EventBridge es 生成模板
<a name="pipes-generate-template-console"></a>

要使用 EventBridge 控制台从一个或多个管道生成 CloudFormation 模板，请执行以下操作：

**从一个或多个管道生成 CloudFormation 模板**

1. 打开 Amazon EventBridge 控制台，网址为[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)。

1. 在导航窗格中，选择**管道**。

1. 在 “**管道**” 下，选择要包含在生成的 CloudFormation 模板中的一个或多个管道。

   对于单条管道，您也可以选择管道名称以显示其详细信息页面。

1. 选择 “**CloudFormation 模板**”，然后选择 EventBridge 要生成模板的格式：**JSON** 或 **YAML**。

   EventBridge 显示以选定格式生成的模板。

1. 如果您为任何选定的管道 EventBridge 创建了新的执行角色，并且想要 EventBridge 将这些角色包含在模板中，请选择 “**包括控制台代表您创建的 IAM 角色**”。

1. EventBridge 允许您选择下载模板文件或将模板复制到剪贴板。
   + 选择**下载**，下载模板文件。
   + 要将此模板复制到剪贴板，请选择**复制**。

1. 要退出模板，请选择**取消**。