Ini adalah *Panduan Referensi CloudFormation Template* baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat [Panduan AWS CloudFormation Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Fungsi intrinsik `Fn::Transform` menentukan makro untuk melakukan pemrosesan kustom pada bagian dari templat tumpukan. Makro memungkinkan Anda untuk melakukan pemrosesan kustom pada template, dari tindakan sederhana seperti find-and-replace operasi hingga transformasi ekstensif dari seluruh template. Untuk informasi selengkapnya, lihat [Menggunakan CloudFormation makro untuk melakukan pemrosesan kustom pada templat](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html) di *Panduan AWS CloudFormation Pengguna*.

Anda juga dapat menggunakan `Fn::Transform` untuk memanggil [Tansformasi `AWS::Include`](transform-aws-include.md) transformasi, yang merupakan makro yang dihosting oleh CloudFormation.

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

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

Sintaks untuk nama fungsi penuh:

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

Sintaks untuk bentuk pendek:

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

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

Sintaks untuk nama fungsi penuh:

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

Sintaks untuk bentuk pendek:

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

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

`Name`  
Nama makro yang ingin Anda lakukan pemrosesan.

`Parameters`  
Daftar parameter, ditetapkan sebagai pasangan kunci-nilai, untuk dilewatkan ke makro.

## Nilai yang dikembalikan
<a name="intrinsic-function-reference-transform-returnvalue"></a>

Cuplikan templat yang diproses untuk dimasukkan dalam templat tumpukan yang diproses.

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

Contoh berikut memanggil `AWS::Include` transformasi, menentukan bahwa lokasi untuk mengambil cuplikan template dari diteruskan dalam parameter. `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
```

## Fungsi yang didukung
<a name="intrinsic-function-reference-transform-supported-functions"></a>

Tidak ada.

CloudFormation meneruskan panggilan fungsi intrinsik apa pun yang disertakan `Fn::Transform` ke makro yang ditentukan sebagai string literal.