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á.

# Detalhes e exemplos de parâmetros do arquivo Service CloudFormation IaC
<a name="svc-parameters"></a>

Você pode definir e referenciar parâmetros em seus arquivos de serviço e pipeline de infraestrutura como código (IaC). Para obter uma descrição detalhada dos parâmetros do AWS Proton , dos tipos de parâmetros, do namespace do parâmetro e de como usar os parâmetros em seus arquivos IaC, consulte [AWS Proton parâmetros](parameters.md).

## Definir parâmetros de serviço
<a name="svc-parameters.define"></a>

Você pode definir os parâmetros de entrada e saída para arquivos IaC do serviço.
+ **Parâmetros de entrada**: Defina os parâmetros de instância de serviço do ambiente em seu [arquivo de esquema](ag-schema.md).

  A lista a seguir inclui exemplos de parâmetros de entrada de serviço para casos de uso típicos.
  + Porta
  + Tamanho da tarefa
  + Imagem
  + Contagem desejada
  + Arquivo Docker
  + Comando de teste unitário

  Você fornece valores para os parâmetros de entrada ao [criar um serviço](ag-create-svc.md):
  + Use o console para preencher um formulário baseado em esquema que AWS Proton fornece.
  + Use a CLI para fornecer uma especificação que inclua os valores.
+ **Parâmetros de saída**: Defina as saídas da instância de serviço em seus arquivos IaC de serviço. Você pode então consultar essas saídas em arquivos IaC de outros recursos.

## Leia valores de parâmetros em arquivos IaC de serviço
<a name="svc-parameters.refer"></a>

Você pode ler os parâmetros relacionados ao serviço e a outros recursos nos arquivos do serviço IaC. Você lê o valor de um parâmetro fazendo referência ao nome do parâmetro no namespace do AWS Proton parâmetro.
+ **Parâmetros de entrada**: Leia um valor de instância do serviço fazendo referência a `service_instance.inputs.{{input-name}}`.
+ **Parâmetros** do AWS Proton recurso — Leia os parâmetros do recurso fazendo referência a nomes como `service.name``service_instance.name`, e. `environment.name`
+ **Parâmetros de saída**: Leia as saídas de outros recursos referenciando `environment.outputs.{{output-name}}` ou `service_instance.components.default.outputs.{{output-name}}`.

## Exemplo de arquivo IaC de serviço com parâmetros
<a name="svc-parameters.example"></a>

O exemplo a seguir é um trecho de um arquivo CloudFormation IaC de serviço. O namespace `environment.outputs.` se refere às saídas do ambiente de um arquivo IaC do ambiente. O namespace `service_instance.inputs.` se refere aos parâmetros de entrada da instância de serviço. A `service_instance.name` propriedade se refere a um parâmetro AWS Proton de recurso.

```
Resources:
  StoreServiceInstanceInputValue:
    Type: AWS::SSM::Parameter
    Properties:
      Type: String
      Value: "{{ service.name }} {{ service_instance.name }} {{ service_instance.inputs.my_sample_service_instance_required_input }} {{ service_instance.inputs.my_sample_service_instance_optional_input }} {{ environment.outputs.MySampleInputValue }} {{ environment.outputs.MyOtherSampleInputValue }}"
              #  resource parameter references               # input parameter references                                                                                                                    # output references to an environment infrastructure as code file
Outputs:
  MyServiceInstanceParameter:                                                         # output definition
    Value: !Ref StoreServiceInstanceInputValue 
  MyServiceInstanceRequiredInputValue:                                                # output definition
    Value: "{{ service_instance.inputs.my_sample_service_instance_required_input }}"  # input parameter reference
  MyServiceInstanceOptionalInputValue:                                                # output definition
    Value: "{{ service_instance.inputs.my_sample_service_instance_optional_input }}"  # input parameter reference
  MyServiceInstancesEnvironmentSampleOutputValue:                                     # output definition
    Value: "{{ environment.outputs.MySampleInputValue }}"                             # output reference to an environment IaC file
  MyServiceInstancesEnvironmentOtherSampleOutputValue:                                # output definition
    Value: "{{ environment.outputs.MyOtherSampleInputValue }}"                        # output reference to an environment IaC file
```