As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerando um CloudFormation modelo a partir do EventBridge Pipes
<a name="pipes-generate-template"></a>

AWS CloudFormation permite que você configure e gerencie seus AWS recursos em contas e regiões de forma centralizada e repetível, tratando a infraestrutura como código. CloudFormation faz isso permitindo que você crie *modelos*, que definem os recursos que você deseja provisionar e gerenciar.

EventBridge permite que você gere modelos a partir dos canais existentes em sua conta, como uma ajuda para ajudá-lo a começar a desenvolver CloudFormation modelos. É possível selecionar um único pipe ou vários pipes para incluir no modelo. Em seguida, você pode usar esses modelos como base para [criar pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) de recursos sob CloudFormation gerenciamento.

Para obter mais informações sobre CloudFormation, consulte [*o Guia CloudFormation do Usuário*.](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)

Para ônibus de eventos, você pode gerar CloudFormation modelos a partir de [ônibus de eventos](eb-generate-event-bus-template.md) [e regras de ônibus de eventos](rule-generate-template.md).

## Recursos incluídos nos modelos EventBridge do Pipe
<a name="pipes-generate-template-resources"></a>

Ao EventBridge gerar o CloudFormation modelo, ele cria um [AWS::Pipes::Pipe](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-pipes-pipe.html)recurso para cada canal selecionado. Além disso, EventBridge inclui os seguintes recursos nas condições descritas:
+ [AWS::Events::ApiDestination](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-apidestination.html)

  Se seus canais incluírem destinos de API, como enriquecimentos ou alvos, EventBridge inclua-os no CloudFormation modelo como AWS::Events::ApiDestination recursos.
+ [AWS::Events::EventBus](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html)

  Se seus canais incluírem um barramento de eventos como destino, EventBridge inclua-o no CloudFormation modelo como um AWS::Events::EventBus recurso.
+ [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)

  Se você EventBridge criou uma nova função de execução ao [configurar o pipe](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-pipes-create.html#pipes-configure-pipe-settings), pode optar por EventBridge incluir essa função no modelo como um AWS::IAM::Role recurso. EventBridge não inclui funções que você cria. (Em ambos os casos, a `RoleArn` propriedade do AWS::Pipes::Pipe recurso contém o ARN da função.)

## Considerações ao usar CloudFormation modelos gerados a partir de Pipes EventBridge
<a name="pipes-generate-template-considerations"></a>

Considere os seguintes fatores ao usar um CloudFormation modelo que você gerou a partir de EventBridge:
+ EventBridge não inclui nenhuma senha no modelo gerado.

  É possível editar o modelo para incluir [parâmetros de modelo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) que permitam aos usuários especificar senhas ou outras informações confidenciais ao usar o modelo para criar ou atualizar uma pilha do CloudFormation.

  Além disso, os usuários podem usar o Secrets Manager para criar um segredo na região desejada e depois editar o modelo gerado para empregar [parâmetros dinâmicos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager).
+ Os destinos no modelo gerado permanecem exatamente como foram especificados no pipe original. Isso poderá resultar em problemas entre regiões se você não editar adequadamente o modelo antes de utilizá-lo para criar pilhas em outras regiões.

  Além disso, o modelo gerado não cria os destinos downstream automaticamente.

## Gerando um CloudFormation modelo a partir do EventBridge Pipes
<a name="pipes-generate-template-console"></a>

Para gerar um CloudFormation modelo a partir de um ou mais tubos usando o EventBridge console, faça o seguinte: 

**Para gerar um CloudFormation modelo a partir de um ou mais tubos**

1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Pipes**.

1. Em **Tubos**, escolha um ou mais tubos que você deseja incluir no CloudFormation modelo gerado.

   Para um único pipe, também é possível escolher o nome do pipe para exibir a página de detalhes do pipe.

1. Escolha **CloudFormation Modelo** e, em seguida, escolha em qual formato você EventBridge deseja gerar o modelo: **JSON** ou **YAML**.

   EventBridge exibe o modelo, gerado no formato selecionado.

1. Se você EventBridge criou uma nova função de execução para qualquer um dos canais selecionados e EventBridge deseja incluir essas funções no modelo, escolha **Incluir IAM funções criadas pelo console em seu nome**.

1. EventBridge oferece a opção de baixar o arquivo de modelo ou copiar o modelo para a área de transferência.
   + Para baixar o arquivo de modelo, escolha **Baixar**.
   + Para copiar o modelo para a área de transferência, escolha **Copiar**.

1. Para sair do modelo, escolha **Cancelar**.