Fn::Join

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

JSON

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

YAML

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 ] ]

Paramètres

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

Chaîne combinée.

Exemples

Associer une matrice à chaîne simple

L'exemple suivant renvoie : "a:b:c".

JSON

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

YAML

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

Associer à l'aide de la fonction Ref avec Paramètres

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

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

YAML

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

Note

Consultez également la fonction Fn::Sub pour une fonctionnalité similaire.

Fonctions prises en charge

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