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 des modèles, d'actions simples telles que des opérations de recherche et de remplacement, jusqu'à des transformations importantes des modèles complets. Pour plus d’informations, consultez Utilisation des macros CloudFormation pour effectuer un traitement personnalisé sur les modèles dans le Guide de l’utilisateur AWS CloudFormation.

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

Déclaration

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

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

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

!Transform
  Name: macro name
  Parameters:
    Key: value

Paramètres

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.

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

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

Fonctions prises en charge

Aucune.

CloudFormation transmet tous les appels de fonction intrinsèque inclus dans Fn::Transform à la macro spécifiée sous forme de chaînes littérales.