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::Join`
<a name="intrinsic-function-reference-join"></a>

A função intrínseca `Fn::Join` anexa um conjunto de valores em um único valor, separados pelo delimitador especificado. Se um delimitador é a string vazia, o conjunto de valores é concatenado sem delimitador.

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

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

```
{ "Fn::Join" : [ "delimiter", [ comma-delimited list of values ] ] }
```

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

Sintaxe para o nome da função completo:

```
Fn::Join: [ delimiter, [ comma-delimited list of values ] ]
```

Sintaxe para a forma resumida:

```
!Join [ delimiter, [ comma-delimited list of values ] ]
```

## Parâmetros
<a name="intrinsic-function-reference-join-parameters"></a>

delimitador  
O valor que você deseja que ocorra entre estilhaços. O delimitador ocorrerá apenas entre estilhaços. Não encerrará o valor final.

ListOfValues  
A lista de valores a ser combinados.

## Valor de retorno
<a name="intrinsic-function-reference-join-returnvalues"></a>

A string combinada.

## Exemplos
<a name="intrinsic-function-reference-join-examples"></a>

### Unir uma matriz de strings simples
<a name="intrinsic-function-reference-join-example1"></a>

O seguinte exemplo retorna: `"a:b:c"`.

#### JSON
<a name="intrinsic-function-reference-join-example1.json"></a>

```
"Fn::Join" : [ ":", [ "a", "b", "c" ] ]
```

#### YAML
<a name="intrinsic-function-reference-join-example1.yaml"></a>

```
!Join [ ":", [ a, b, c ] ]
```

### Unir usando a função Ref com parâmetros
<a name="intrinsic-function-reference-join-example2"></a>

O exemplo a seguir usa `Fn::Join` para construir um valor de string. Ele usa a função `Ref` com o parâmetro `AWS::Partition` e o pseudoparâmetro `AWS::AccountId`.

#### JSON
<a name="intrinsic-function-reference-join-example2.json"></a>

```
{
  "Fn::Join": [
    "", [
      "arn:",
      {
        "Ref": "AWS::Partition"
      },
      ":s3:::elasticbeanstalk-*-",
      {
        "Ref": "AWS::AccountId"
      }
    ]
  ]
}
```

#### YAML
<a name="intrinsic-function-reference-join-example2.yaml"></a>

```
!Join
  - ''
  - - 'arn:'
    - !Ref AWS::Partition
    - ':s3:::elasticbeanstalk-*-'
    - !Ref AWS::AccountId
```

**nota**  
Consulte também a função [`Fn::Sub`](intrinsic-function-reference-sub.md) para funcionalidade semelhante.

## Funções compatíveis
<a name="intrinsic-function-reference-join-supportedfunctions"></a>

No delimitador `Fn::Join`, não é possível usar nenhuma função. É necessário especificar um valor de string.

Para a lista de valores `Fn::Join`, use as seguintes funções:
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::GetAtt`
+ `Fn::GetAZs`
+ `Fn::If`
+ `Fn::ImportValue`
+ `Fn::Join`
+ `Fn::Split`
+ `Fn::Select`
+ `Fn::Sub`
+ `Ref`