Aviso de fim do suporte: em 7 de outubro de 2026, AWS encerrará o suporte para AWS Proton. Depois de 7 de outubro de 2026, você não poderá mais acessar o AWS Proton console ou os AWS Proton recursos. Sua infraestrutura implantada permanecerá intacta. Para obter mais informações, consulte o Guia [AWS Proton de descontinuação e migração de serviços](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html).
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á.
# AWS Proton parâmetros
Você pode definir e usar parâmetros em seus arquivos de infraestrutura como código (IaC) para torná-los flexíveis e reutilizáveis. Você lê um valor de parâmetro em seus arquivos IaC fazendo referência ao nome do parâmetro no *namespace do AWS Proton parâmetro*. AWS Proton injeta valores de parâmetros nos arquivos IaC renderizados que ele gera durante o provisionamento de recursos. Para processar os parâmetros AWS CloudFormation do IaC, AWS Proton usa o [Jinja](https://jinja.palletsprojects.com/en/2.11.x/). Para processar os parâmetros do Terraform IaC, AWS Proton gera um arquivo de valor do parâmetro do Terraform e conta com a capacidade de parametrização incorporada ao HCL.
Com[CodeBuild aprovisionamento](ag-works-prov-methods.md#ag-works-prov-methods-codebuild), AWS Proton gera um arquivo de entrada que seu código pode importar. O arquivo é um arquivo JSON ou HCL, dependendo de uma propriedade no manifesto do seu modelo. Para obter mais informações, consulte [CodeBuild detalhes e exemplos de parâmetros de provisionamento](parameters-codebuild.md).
Você pode consultar os parâmetros em seus arquivos IaC de ambiente, serviço e componente ou código de provisionamento com os seguintes requisitos:
+ O tamanho de cada nome de parâmetro não excede 100 caracteres.
+ O tamanho do namespace do parâmetro e do nome do recurso combinados não excede o limite de caracteres para o nome do recurso.
AWS Proton o provisionamento falhará se essas cotas forem excedidas.
## Tipos de parâmetros
Os seguintes tipos de parâmetros estão disponíveis para referência nos arquivos AWS Proton IaC:
**Parâmetro de entrada**
Ambientes e instâncias de serviço podem usar parâmetros de entrada que você define em um [arquivo de esquema](ag-schema.md) que você associa ao ambiente ou ao modelo de serviço. Você pode consultar os parâmetros de entrada de um recurso no arquivo IaC do recurso. Os arquivos IaC do componente podem se referir aos parâmetros de entrada da instância de serviço à qual o componente está anexado.
AWS Proton verifica os nomes dos parâmetros de entrada em relação ao seu arquivo de esquema e os compara com os parâmetros referenciados nos seus arquivos IaC para injetar os valores de entrada que você fornece em um arquivo de especificação durante o provisionamento de recursos.
**Parâmetro de saída**
Você pode definir saídas em qualquer um dos seus arquivos IaC. Uma saída pode ser, por exemplo, um nome, ID ou ARN de um dos recursos provisionados pelo modelo, ou pode ser uma forma de passar por uma das entradas do modelo. Você pode consultar essas saídas em arquivos IaC de outros recursos.
Nos arquivos CloudFormation IaC, defina os parâmetros de saída no `Outputs:` bloco. Em um arquivo Terraform IaC, defina cada parâmetro de saída usando uma instrução de `output`.
**Parâmetro de recurso**
AWS Proton cria automaticamente parâmetros AWS Proton de recursos. Esses parâmetros expõem as propriedades do objeto de AWS Proton recurso. Um exemplo de parâmetro de recurso é `environment.name`.
## Usando AWS Proton parâmetros em seus arquivos IaC
Para ler um valor de parâmetro em um arquivo IaC, você se refere ao nome do parâmetro no namespace do AWS Proton parâmetro. Para arquivos AWS CloudFormation IaC, você usa a sintaxe *Jinja* e delimita o parâmetro com pares de chaves e aspas.
A tabela a seguir mostra a sintaxe de referência para cada linguagem de modelo compatível, com um exemplo.
| Linguagem do modelo | Sintaxe | Exemplo: entrada de ambiente chamada “VPC” |
| --- | --- | --- |
| CloudFormation | `"{{ parameter-name }}"` | `"{{ environment.inputs.VPC }}"` |
| Terraform | `var.parameter-name` | `var.environment.inputs.VPC` [Definições de variáveis do Terraform geradas](ag-infrastructure-tmp-files-terraform.md#compiled-tform) |
**nota**
Se você usar [parâmetros CloudFormation dinâmicos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html) em seu arquivo IaC, deverá [evitá-los para evitar erros de](https://jinja.palletsprojects.com/en/2.11.x/templates/#escaping) interpretação errônea do Jinja. Para obter mais informações, consulte [Solução de problemas AWS Proton](ag-troubleshooting.md).
A tabela a seguir lista os nomes dos namespaces para todos os parâmetros do AWS Proton recurso. Cada tipo de arquivo de modelo pode usar um subconjunto diferente do namespace do parâmetro.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/parameters.html)
Para obter mais informações e exemplos, consulte os subtópicos sobre parâmetros nos arquivos de modelo de IaC para diferentes tipos de recursos e linguagens de modelo.
**Topics**
+ [Tipos de parâmetros](#param-name-types)
+ [Usando AWS Proton parâmetros em seus arquivos IaC](#param-name-spaces)
+ [Detalhes e CloudFormation exemplos de parâmetros do arquivo Environment IaC](env-parameters.md)
+ [Detalhes e exemplos de parâmetros do arquivo Service CloudFormation IaC](svc-parameters.md)
+ [Detalhes e exemplos de parâmetros do arquivo do componente CloudFormation IaC](comp-parameters.md)
+ [Filtros de parâmetros para arquivos CloudFormation IaC](parameter-filters.md)
+ [CodeBuild detalhes e exemplos de parâmetros de provisionamento](parameters-codebuild.md)
+ [Detalhes e exemplos de parâmetros de arquivo de infraestrutura como código (IaC) do Terraform](env-parameters-tform.md)