# Use links de criação rápida para criar pilhas do CloudFormation
Os links de criação rápida fornecem um método simplificado para iniciar pilhas do CloudFormation diretamente de URLs no console do CloudFormation. Ao especificar o modelo de URL, o nome da pilha e parâmetros do modelo como parâmetros de consulta de URL, é possível preencher previamente uma única página de **Criar pilha** para acelerar a criação de uma pilha. Isso simplifica o processo de criação de pilhas, reduzindo tanto o número de páginas do assistente quanto a quantidade de entrada do usuário necessária. Isso também otimiza a reutilização de modelos, pois você pode criar vários URLs que especificam valores diferentes para o mesmo modelo.
## Formato do URL
O link de criação rápida segue este formato de URL:
```
https://{{region-code}}.console.aws.amazon.com/cloudformation/home?region={{region-code}}#/stacks/create/review
?templateURL={{TemplateURL}}
&stackName={{StackName}}
¶m_{{parameterName}}={{parameterValue}}
```
O CloudFormation é compatível com os seguintes parâmetros de consulta de URL:
URL do modelo
Obrigatório. O parâmetro `templateURL` especifica o URL do modelo de pilha localizado em um bucket do Amazon S3. Para evitar problemas de acesso com um URL do S3 pré-assinado, certifique-se de codificar o URL.
Formatos de URL do S3 válidos:
+ `https://s3.{{region-code}}.amazonaws.com/{{bucket-name}}/{{template-name}}`
+ `https://{{bucket-name}}.s3.{{region-code}}.amazonaws.com/{{template-name}}`
+ `https://s3-{{region-code}}.amazonaws.com/{{bucket-name}}/{{template-name}}` (formato legado)
Nome da pilha
Opcional. Use o parâmetro `stackName` para especificar o nome da pilha do CloudFormation a ser criada. Um nome de pilha pode conter apenas caracteres alfanuméricos (sensíveis a maiúsculas e minúsculas) e hifens. Ele deve começar com um caractere alfabético e não pode ter mais de 128 caracteres.
Parâmetros do modelo
Opcional. Para parâmetros no modelo de pilha que não são do tipo de parâmetro `NoEcho`, use o formato `param_{{parameterName}}` na string de consulta do URL. O parâmetro de URL deve incluir o prefixo `param_` e o segmento do nome do parâmetro deve corresponder exatamente ao nome do parâmetro no modelo. Por exemplo: `param_DBName`.
O CloudFormation ignora os parâmetros que não existem no modelo e quaisquer parâmetros definidos com a propriedade `NoEcho` definida como tipos `true` (geralmente, nomes de usuário e senhas). Os parâmetros de URL substituem os valores padrão que são especificados no modelo. Inclua quantos parâmetros forem necessários.
Em vez de incorporar informações confidenciais diretamente em modelos do CloudFormation, recomendamos usar os parâmetros dinâmicos no modelo da pilha para fazer referência a informações confidenciais que são armazenadas e gerenciadas de forma externa ao CloudFormation, como no AWS Systems Manager Parameter Store ou no AWS Secrets Manager.
Para obter mais informações, consulte a prática recomendada [Não incorporar credenciais nos seus modelos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/security-best-practices.html#creds).
Todos os nomes de parâmetro de consulta diferenciam maiúsculas de minúsculas. Os usuários podem substituir esses valores no console antes de criar a pilha.
## Exemplo
O exemplo a seguir é baseado no modelo de exemplo da [ Instância básica única do WordPress](https://s3.us-east-2.amazonaws.com/cloudformation-templates-us-east-2/WordPress_Single_Instance.template). A string de consulta inclui o parâmetro `templateURL` obrigatório e os parâmetros `stackName`, `DBName`, `InstanceType` e `KeyName`.
O URL a seguir tem quebras de linha adicionadas para oferecer clareza.
```
https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review
?templateURL=https://s3.us-east-2.amazonaws.com/cloudformation-templates-us-east-2/WordPress_Single_Instance.template
&stackName=MyWPBlog
¶m_DBName=mywpblog
¶m_InstanceType=t2.medium
```
O URL a seguir inclui os mesmos parâmetros do exemplo anterior, mas as quebras de linha foram removidas. Este é o formato real do URL.
```
https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review?templateURL=https://s3.us-east-2.amazonaws.com/cloudformation-templates-us-east-2/WordPress_Single_Instance.template&stackName=MyWPBlog¶m_DBName=mywpblog¶m_InstanceType=t2.medium
```
## Criando uma pilha usando um link de criação rápida
Ao abrir um link de criação rápida, você é direcionado para o console do CloudFormation. O console abre diretamente na página **Criar pilha rapidamente**, com os valores fornecidos usados automaticamente para os parâmetros.
**Para criar uma pilha usando um link de criação rápida (console)**
1. Na página **Criar pilha rapidamente**, em **Modelo**, **URL do modelo**, confirme se o URL do modelo está correto.
1. Expanda a seção **Visualizar modelo** para verificar o modelo.
1. Em **Nome da pilha**, verifique o nome da pilha pré-preenchido.
1. Revise a seção **Parâmetros**. Verifique se os valores dos parâmetros pré-preenchidos estão corretos. Preencha todos os parâmetros obrigatórios que não foram especificados no URL. Modifique quaisquer valores pré-preenchidos, se necessário.
1. Agora, é possível definir as seguintes configurações:
+ **Tags** — Organize recursos com pares de chave-valor.
+ **Permissões**: escolha o perfil de serviço do IAM para operações de pilha.
+ **Opções de falha na pilha** — Escolha reverter (padrão) ou preservar recursos.
+ **Política de pilha** — Controle as permissões de atualização de recursos.
+ **Configuração de reversão — Configure a reversão** baseada em alarme do CloudWatch.
+ **Opções de notificação** — Configure notificações do Amazon SNS para eventos de pilha.
+ **Opções de criação de pilha** — Defina o tempo máximo de criação da pilha e ative a proteção contra encerramento para evitar exclusões acidentais.
Para obter mais informações, consulte [Configurar opções da pilha](cfn-console-create-stack.md#configure-stack-options).
1. Para **Capacidades**, preencha todas as confirmações necessárias. Se o seu modelo contém recursos do IAM, selecione **I acknowledge that this template may create IAM resources (Eu reconheço que este modelo pode criar recursos do IAM)** para especificar que você deseja usar recursos do IAM no modelo. Para obter mais informações, consulte [Confirmar recursos do IAM em modelos do CloudFormation](control-access-with-iam.md#using-iam-capabilities).
1. (Opcional) É possível criar um conjunto de alterações para visualizar a configuração da pilha do antes de criá-la. Escolha **Criar conjunto de alterações** e siga as instruções. Para obter mais informações, consulte [Visualizar a configuração da sua pilha](cfn-console-create-stack.md#cfn-console-create-stacks-changesets).
1. **Quando estiver pronto, escolha **Criar pilha para iniciar a pilha** e, em seguida, monitore o progresso da criação da pilha na guia Eventos.** Para obter mais informações, consulte [Monitorar o progresso da pilha](monitor-stack-progress.md).