Este é o novo *Guia de referência de modelos do CloudFormation*. Atualize seus favoritos e links. Para obter ajuda para começar a usar o CloudFormation, consulte o [Guia do usuário do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# `Fn::Base64`
<a name="intrinsic-function-reference-base64"></a>

A função intrínseca `Fn::Base64` retorna a representação Base64 da string de entrada. Essa função normalmente é usada para passar dados codificados para instâncias do Amazon EC2 por meio da propriedade `UserData`.

## Declaração
<a name="w2aac24c12b5"></a>

### JSON
<a name="intrinsic-function-reference-base64-syntax.json"></a>

```
{ "Fn::Base64" : valueToEncode }
```

### YAML
<a name="intrinsic-function-reference-base64-syntax.yaml"></a>

Sintaxe para o nome da função completo:

```
Fn::Base64: valueToEncode
```

Sintaxe para a forma resumida:

```
!Base64 valueToEncode
```

**nota**  
Caso você use a forma curta e inclua imediatamente outra função no parâmetro `valueToEncode`, use o nome da função completo em pelo menos uma das funções. Por exemplo, a sintaxe a seguir não é válida:  

```
!Base64 !Sub string
!Base64 !Ref logical_ID
```
Em vez disso, use o nome da função completo em pelo menos uma das funções, conforme mostrado nos seguintes exemplos:  

```
!Base64
  "Fn::Sub": string

Fn::Base64:
  !Sub string
```

## Parameters
<a name="w2aac24c12b7"></a>

valueToEncode  
O valor da string que você deseja converter em Base64.

## Valor de retorno:
<a name="w2aac24c12b9"></a>

A string original, em representação Base64.

## Exemplos
<a name="w2aac24c12c11"></a>

### JSON
<a name="intrinsic-function-reference-base64-example.json"></a>

```
{ "Fn::Base64" : "AWS CloudFormation" }
```

### YAML
<a name="intrinsic-function-reference-base64-example.yaml"></a>

```
Fn::Base64: AWS CloudFormation
```

## Funções compatíveis
<a name="w2aac24c12c13"></a>

Você pode usar qualquer função que retorne uma string dentro da função `Fn::Base64`.