這是新的 *CloudFormation 範本參考指南*。請更新您的書籤和連結。如需 CloudFormation 入門的說明，請參閱 [AWS CloudFormation 使用者指南](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

內部函數 `Fn::Transform` 指定在堆疊範本的一部分執行自訂處理的巨集。巨集可讓您在範本上執行自訂處理，例如尋找和取代操作這種簡單動作，乃至於全部範本的大規模轉換。如需詳細資訊，請參閱《AWS CloudFormation 使用者指南》**中的[使用 CloudFormation 巨集對範本執行自訂處理](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html)。

您也可以使用 `Fn::Transform` 呼叫 [`AWS::Include` 轉換程序](transform-aws-include.md) 轉換，這是由 託管的巨集 CloudFormation。

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

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

完整函式名稱的語法：

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

短格式的語法：

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

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

完整函式名稱的語法：

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

短格式的語法：

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

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

`Name`  
您要執行處理的巨集名稱。

`Parameters`  
要傳遞到巨集的清單參數 (以鍵值組指定)。

## 傳回值
<a name="intrinsic-function-reference-transform-returnvalue"></a>

要納入所處理堆疊範本中的已處理範本程式碼片段。

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

以下範例呼叫 `AWS::Include` 轉換，其中指定將擷取範本程式碼片段的來源位置傳入 `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
```

## 支援的函數
<a name="intrinsic-function-reference-transform-supported-functions"></a>

無。

CloudFormation 以文字字串將 `Fn::Transform` 包含的任何內部函數呼叫傳遞至指定的巨集。