View a markdown version of this page

Fn : : FindInMap améliorations - AWS CloudFormation
DéclarationParametersExemplesFonctions prises en chargeRessources connexes

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.

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 : : FindInMap améliorations

La AWS::LanguageExtensions transformation améliore la fonctionnalité de la fonction Fn::FindInMap intrinsèque dans les CloudFormation modèles.

La Fn::FindInMap fonction standard prend en charge uniquement Fn::FindInMap et en Ref tant que fonctions intrinsèques imbriquées. La AWS::LanguageExtensions transformation supprime cette limitation, vous permettant d'utiliser un plus large éventail de fonctions intrinsèques pour définir les paramètres deFn::FindInMap.

Note

Le DefaultValue paramètre for Fn::FindInMap ne nécessite plus la AWS::LanguageExtensions transformation. Vous pouvez l'utiliser DefaultValue dans n'importe quel CloudFormation modèle. Pour de plus amples informations, veuillez consulter Ventilateur : FindInMap.

Déclaration

JSON

{ "Fn::FindInMap" : [ "MapName", "TopLevelKey", "SecondLevelKey"] }

Si vous souhaitez spécifier une valeur de remplacement lorsqu'une clé n'est pas trouvée dans le mappage, incluez DefaultValue :

{ "Fn::FindInMap" : [ "MapName", "TopLevelKey", "SecondLevelKey", {"DefaultValue": "DefaultValue"}] }

YAML

Syntaxe pour le nom complet de la fonction :

Fn::FindInMap: [ MapName, TopLevelKey, SecondLevelKey ]

Syntaxe pour la forme courte :

!FindInMap [ MapName, TopLevelKey, SecondLevelKey ]

Si vous souhaitez spécifier une valeur de remplacement lorsqu'une clé n'est pas trouvée dans le mappage, incluez DefaultValue :

Syntaxe pour le nom complet de la fonction :

Fn::FindInMap:
  - MapName
  - TopLevelKey
  - SecondLevelKey
  - DefaultValue: DefaultValue

Syntaxe pour la forme courte :

!FindInMap
  - MapName
  - TopLevelKey
  - SecondLevelKey
  - DefaultValue: DefaultValue

Parameters

Avec la AWS::LanguageExtensions transformation, les paramètresMapName, TopLevelKeySecondLevelKey, et DefaultValue peuvent chacun être une fonction intrinsèque, à condition qu'ils soient résolus à une valeur valide pendant la transformation.

Exemples

Les exemples suivants montrent comment utiliser des fonctions intrinsèques dans les paramètres de Fn::FindInMap l'ajout de la AWS::LanguageExtensions transformation.

Utilisation de fonctions intrinsèques pour définir la clé de premier niveau

L’exemple suivant illustre l’utilisation d’une fonction Fn::FindInMap avec les fonctions intrinsèques Fn::Select et Fn::Split vectorisées, afin de définir la clé de premier niveau.

JSON

{
  //...
  "Transform": "AWS::LanguageExtensions",
  //...
      "Fn::FindInMap": [
        "MyMap",
        {
          "Fn::Select": [
            0,
            {
              "Fn::Split": [
                "|",
                { "Ref": "InputKeys" }
              ]
            }
          ]
        },
        "SecondKey"
      ]
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
    !FindInMap: [MyMap, !Select [0, !Split [|, !Ref InputKeys]], SecondKey]
#...

Fonctions prises en charge

Vous pouvez utiliser les fonctions suivantes dans les paramètres Fn::FindInMap de la AWS::LanguageExtensions transformation :

Ressources connexes

Pour plus d'informations et des exemples illustrant comment utiliser la fonction Fn::FindInMap intrinsèque, y compris le DefaultValue paramètre, consultezVentilateur : FindInMap.

Pour plus d'informations sur la transformation AWS::LanguageExtensions, consultez Transformation AWS::LanguageExtensions.