Questa è la nuova *Guida di riferimento ai modelli CloudFormation *. Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la [Guida AWS CloudFormation per l'utente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

La funzione intrinseca `Fn::Transform` specifica una macro per eseguire un’elaborazione personalizzata di una parte di un modello di stack. Le macro consentono di eseguire elaborazioni personalizzate sui modelli, da azioni semplici come find-and-replace operazioni a trasformazioni estese di interi modelli. *Per ulteriori informazioni, vedere [Utilizzo delle CloudFormation macro per eseguire l'elaborazione personalizzata sui modelli](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html) nella Guida per l'AWS CloudFormation utente.*

È inoltre possibile utilizzare `Fn::Transform` per chiamare la [Trasformazione `AWS::Include`](transform-aws-include.md) trasformazione, che è una macro ospitata da CloudFormation.

## Dichiarazione
<a name="intrinsic-function-reference-transform-declaration"></a>

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

Sintassi per il nome completo della funzione:

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

Sintassi per la forma breve:

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

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

Sintassi per il nome completo della funzione:

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

Sintassi per la forma breve:

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

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

`Name`  
Il nome della macro che deve eseguire l’elaborazione.

`Parameters`  
I parametri di elenco, specificati come coppie chiave-valore, da passare alla macro.

## Valore restituito
<a name="intrinsic-function-reference-transform-returnvalue"></a>

Il frammento di modello elaborato da includere nel modello di stack elaborato.

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

L’esempio seguente chiama la trasformazione `AWS::Include`, specificando che la posizione da cui recuperare un frammento di modello viene passato nel parametro `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
```

## Funzioni supportate
<a name="intrinsic-function-reference-transform-supported-functions"></a>

Nessuna.

CloudFormation passa tutte le chiamate di funzione intrinseche incluse nella `Fn::Transform` macro specificata come stringhe letterali.