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

# Funções
<a name="ebextensions-functions"></a>

É possível usar funções nos arquivos de configuração para preencher valores de propriedades de recursos com informações de outros recursos ou das definições de opção de configuração do Elastic Beanstalk. O Elastic CloudFormation Beanstalk suporta `Ref` funções `Fn::GetAtt` (`Fn::Join`,,) e uma função específica do Elastic Beanstalk,. `Fn::GetOptionSetting`

**Topics**
+ [

## Ref.
](#ebextensions-functions-ref)
+ [

## Fã:: GetAtt
](#ebextensions-functions-getatt)
+ [

## Fn::Join
](#ebextensions-functions-join)
+ [

## Fã:: GetOptionSetting
](#ebextensions-functions-getoptionsetting)

## Ref.
<a name="ebextensions-functions-ref"></a>

Use `Ref` para recuperar a representação de string padrão de um AWS recurso. O valor retornado por `Ref`depende do tipo de recurso e, às vezes, depende também de outros fatores. Por exemplo, um grupo de segurança ([AWS::EC2::SecurityGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html)) retorna o nome ou a ID do grupo de segurança, dependendo se o grupo de segurança está em uma [Amazon Virtual Private Cloud](https://docs.aws.amazon.com/vpc/latest/userguide/) (Amazon VPC) padrão, EC2 clássica ou em uma VPC personalizada.

```
{ "Ref" : "resource name" }
```

**nota**  
Para obter detalhes sobre cada tipo de recurso, incluindo os valores de retorno de `Ref`, consulte [Referência de tipos de recursos da AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) no *Guia do usuário do CloudFormation *.

A partir do [gancho de ciclo de vida do Auto Scaling](environment-resources.md) demonstrativo:

```
Resources:
  lifecyclehook:
    Type: AWS::AutoScaling::LifecycleHook
    Properties:
      AutoScalingGroupName: { "Ref" : "AWSEBAutoScalingGroup" }
```

Você também pode usar `Ref` para recuperar o valor de um CloudFormation parâmetro definido em outro lugar no mesmo arquivo ou em um arquivo de configuração diferente.

## Fã:: GetAtt
<a name="ebextensions-functions-getatt"></a>

Use `Fn::GetAtt` para recuperar o valor de um atributo em um AWS recurso.

```
{ "Fn::GetAtt" : [ "resource name", "attribute name"] }
```

A partir do [gancho de ciclo de vida do Auto Scaling](environment-resources.md) demonstrativo:

```
Resources:
  lifecyclehook:
    Type: AWS::AutoScaling::LifecycleHook
    Properties:
      RoleARN: { "Fn::GetAtt" : [ "hookrole", "Arn"] }
```

Consulte [Fn:: GetAtt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) para obter mais informações.

## Fn::Join
<a name="ebextensions-functions-join"></a>

Use `Fn::Join` para combinar strings com um delimitador. As strings podem ser codificadas ou usar a saída de `Fn::GetAtt` ou `Ref`.

```
{ "Fn::Join" : [ "delimiter", [ "string1", "string2" ] ] }
```

Consulte [Fn::Join](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-join.html) para obter mais informações.

## Fã:: GetOptionSetting
<a name="ebextensions-functions-getoptionsetting"></a>

Use `Fn::GetOptionSetting` para recuperar o valor de uma definição de [opção de configuração](command-options.md) aplicada ao ambiente. 

```
"Fn::GetOptionSetting":
  Namespace: "namespace"
  OptionName: "option name"
  DefaultValue: "default value"
```

No exemplo de [armazenamento de chaves privadas](https-storingprivatekeys.md):

```
Resources:
  AWSEBAutoScalingGroup:
    Metadata:
      AWS::CloudFormation::Authentication:
        S3Auth:
          type: "s3"
          buckets: ["elasticbeanstalk-us-west-2-123456789012"]
          roleName: 
            "Fn::GetOptionSetting": 
              Namespace: "aws:autoscaling:launchconfiguration"
              OptionName: "IamInstanceProfile"
              DefaultValue: "aws-elasticbeanstalk-ec2-role"
```