Il s’agit du nouveau *Guide de référence des modèles CloudFormation *. Veuillez mettre à jour vos favoris et vos liens. Pour obtenir de l'aide pour démarrer CloudFormation, consultez le [guide de AWS CloudFormation l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

La fonction intrinsèque `Fn::Join` ajoute un ensemble de valeurs dans une seule valeur, séparées par le délimiteur spécifié. Si un délimiteur est une chaîne vide, l'ensemble de valeurs est concaténé avec aucun délimiteur.

## Déclaration
<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>

Syntaxe pour le nom complet de la fonction :

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

Syntaxe pour la forme courte :

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

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

delimiter  
Valeur que vous voulez utiliser entre les fragments. Le délimiteur intervient uniquement entre les fragments. Il n'apparaît pas après la valeur finale.

ListOfValues  
Liste des valeurs que vous voulez combiner.

## Valeur renvoyée
<a name="intrinsic-function-reference-join-returnvalues"></a>

Chaîne combinée.

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

### Associer une matrice à chaîne simple
<a name="intrinsic-function-reference-join-example1"></a>

L'exemple suivant renvoie : `"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 ] ]
```

### Associer à l'aide de la fonction Ref avec Paramètres
<a name="intrinsic-function-reference-join-example2"></a>

L'exemple suivant utilise `Fn::Join` pour construire une valeur de chaîne. Il utilise la fonction `Ref` avec le paramètre `AWS::Partition` et le pseudo-paramètre `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
```

**Note**  
Consultez également la fonction [`Fn::Sub`](intrinsic-function-reference-sub.md) pour une fonctionnalité similaire.

## Fonctions prises en charge
<a name="intrinsic-function-reference-join-supportedfunctions"></a>

Avec le délimiteur `Fn::Join`, vous ne pouvez pas utiliser toutes les fonctions. Vous devez spécifier une valeur de type chaîne.

Pour la liste de valeurs `Fn::Join`, vous pouvez utiliser les fonctions suivantes :
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::GetAtt`
+ `Fn::GetAZs`
+ `Fn::If`
+ `Fn::ImportValue`
+ `Fn::Join`
+ `Fn::Split`
+ `Fn::Select`
+ `Fn::Sub`
+ `Ref`