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::Transform`
<a name="intrinsic-function-reference-transform"></a>

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 la section [Utilisation de CloudFormation macros pour effectuer un traitement personnalisé sur des modèles](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html) dans le *Guide de AWS CloudFormation l'utilisateur*.

Vous pouvez également utiliser `Fn::Transform` pour appeler la [Transformation `AWS::Include`](transform-aws-include.md) transformation, qui est une macro hébergée par CloudFormation.

## Déclaration
<a name="intrinsic-function-reference-transform-declaration"></a>

### JSON
<a name="intrinsic-function-reference-transform-syntax.json"></a>

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
<a name="intrinsic-function-reference-transform-syntax.yaml"></a>

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

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

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

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

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

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

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

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
<a name="intrinsic-function-reference-transform-example-1.json"></a>

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

### YAML
<a name="intrinsic-function-reference-transform-example-1.yaml"></a>

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

## Fonctions prises en charge
<a name="intrinsic-function-reference-transform-supported-functions"></a>

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.