Esta es la nueva *Guía de referencia de plantillas de CloudFormation*. Actualice sus marcadores y enlaces. Para obtener ayuda sobre cómo empezar a usar CloudFormation, consulte la [Guía del usuario de AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# `Fn::Transform`
<a name="intrinsic-function-reference-transform"></a>

la función intrínseca `Fn::Transform` especifica una macro para realizar un procesamiento personalizado en parte de una plantilla de pila. Las macros le permiten realizar un procesamiento personalizado de plantillas, desde acciones sencillas como operaciones de búsqueda y reemplazo, hasta amplias transformaciones de plantillas completas. Para obtener más información, consulte [Uso de macros de CloudFormation para llevar a cabo un procesamiento personalizado en plantillas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html) en la *Guía del usuario de AWS CloudFormation*.

También puede utilizar `Fn::Transform` para llamar a la transformación [`AWS::Include`Transformación de](transform-aws-include.md), que es una macro alojado por CloudFormation.

## Declaración
<a name="intrinsic-function-reference-transform-declaration"></a>

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

Sintaxis del nombre de función completo:

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

Sintaxis de la forma abreviada:

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

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

Sintaxis del nombre de función completo:

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

Sintaxis de la forma abreviada:

```
!Transform
  Name: macro name
  Parameters:
    Key: value
```

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

`Name`  
El nombre de la macro que desea que realice el procesamiento.

`Parameters`  
Los parámetros de la lista, especificados como pares clave-valor, que se van a pasar a la macro.

## Valor devuelto
<a name="intrinsic-function-reference-transform-returnvalue"></a>

El fragmento de código de la plantilla procesada que se incluirá en la plantilla de pila procesada.

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

En el siguiente ejemplo se llama a la transformación `AWS::Include` especificando que la ubicación desde la que se recuperará un fragmento de código de plantilla se pasa en el parámetro `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
```

## Funciones compatibles
<a name="intrinsic-function-reference-transform-supported-functions"></a>

Ninguna.

CloudFormation transmite las llamadas de función intrínseca en `Fn::Transform` a la macro especificada como cadenas literales.