Esta es la nueva *Guía de referencia de plantillas de CloudFormation*. Actualice sus marcadores y enlaces. Para obtener ayuda sobre cómo empezar a usar CloudFormation, consulte la [Guía del usuario de AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# `Fn::Join`
<a name="intrinsic-function-reference-join"></a>

La función intrínseca `Fn::Join` añade un conjunto de valores a un único valor separado por el delimitador indicado. Si un delimitador es la cadena vacía, el conjunto de valores se concatena sin delimitador.

## Declaración
<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>

Sintaxis del nombre de función completo:

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

Sintaxis de la forma abreviada:

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

## Parameters
<a name="intrinsic-function-reference-join-parameters"></a>

delimiter  
Es el valor que desea que se produzca entre fragmentos. El delimitador solo se producirá entre fragmentos. No terminará el valor final.

ListOfValues  
Es la lista de valores que desea combinar.

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

La cadena combinada.

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

### Unirse a una matriz de cadenas simple
<a name="intrinsic-function-reference-join-example1"></a>

El ejemplo siguiente devuelve: `"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 ] ]
```

### Unirse mediante la función ref con parámetros
<a name="intrinsic-function-reference-join-example2"></a>

En el siguiente ejemplo se utiliza `Fn::Join` para construir un valor de cadena. Utiliza la función `Ref` con el parámetro `AWS::Partition` y el 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**  
En la función [`Fn::Sub`](intrinsic-function-reference-sub.md) también encontrará una funcionalidad similar.

## Funciones compatibles
<a name="intrinsic-function-reference-join-supportedfunctions"></a>

Para el delimitador `Fn::Join`, no se puede usar ninguna función. Debe especificar un valor de cadena.

Para la lista de valores `Fn::Join`, se pueden usar las siguientes funciones:
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::GetAtt`
+ `Fn::GetAZs`
+ `Fn::If`
+ `Fn::ImportValue`
+ `Fn::Join`
+ `Fn::Split`
+ `Fn::Select`
+ `Fn::Sub`
+ `Ref`