Fn::Transform

La fonction intrinsèque Fn::Transform spécifie une macro pour effectuer un traitement personnalisé sur une partie d'un modèle de pile. Les macros vous permettent d'effectuer un traitement personnalisé sur les modèles, qu'il s'agisse d'actions simples telles que find-and-replace des opérations ou de transformations étendues de modèles entiers. Pour plus d’informations, consultez Utilisation de CloudFormation macros pour effectuer un traitement personnalisé sur les modèles.

Vous pouvez également utiliser Fn::Transform pour appeler la Transformation AWS::Include transformation, qui est une macro hébergée par AWS CloudFormation.

Déclaration

JSON

Syntaxe pour le nom complet de la fonction :

{
    "Fn::Transform": {
        "Name": "macro name",
        "Parameters": {
            "Key": "value"
        }
    }
}

Syntaxe pour la forme courte :

{
    "Transform": {
        "Name": "macro name",
        "Parameters": {
            "Key": "value"
        }
    }
}

YAML

Syntaxe pour le nom complet de la fonction :

Fn::Transform:
  Name : macro name
  Parameters :
    Key : value

Syntaxe pour la forme courte :

!Transform
  Name: macro name
  Parameters:
    Key: value

Paramètres

Nom

Nom de la macro que vous souhaitez utiliser pour effectuer le traitement.

Paramètres

Liste des paramètres, spécifiés en tant que paires clé-valeur, à transmettre à la macro.

Valeur renvoyée

Extrait de modèle traité à inclure dans le modèle de pile traité.

Exemples

L'exemple suivant appelle la transformation AWS::Include, en spécifiant que l'emplacement à partir duquel récupérer un extrait de modèle est transmis dans le paramètre InputValue.

JSON

{
    "Fn::Transform": {
        "Name": "AWS::Include",
        "Parameters": {
            "Location": {
                "Ref": "InputValue"
            }
        }
    }
}

YAML

'Fn::Transform':
  Name: 'AWS::Include'
  Parameters:
    Location: !Ref InputValue

Fonctions prises en charge

Aucune.

CloudFormation transmet tous les appels de fonction intrinsèques inclus dans Fn::Transform la macro spécifiée sous forme de chaînes littérales. Pour plus d'informations, voir CloudFormation interface de fonction macro.