Fn::Transform - AWS CloudFormation
宣告參數傳回值範例支援的函數

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

Fn::Transform

內部函數 Fn::Transform 指定在堆疊範本的一部分執行自訂處理的巨集。巨集可讓您對範本執行自訂處理，從簡單的動作 (例如作 find-and-replace 業) 到整個範本的大量轉換。如需詳細資訊，請參閱 使用 CloudFormation 範本巨集對範本執行自訂處理。

您也可以使用Fn::Transform來呼叫AWS::Include 轉換程序轉換，這是由主控的巨集 AWS CloudFormation。

宣告

JSON

完整函式名稱的語法：

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

短格式的語法：

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

YAML

完整函式名稱的語法：

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

短格式的語法：

!Transform
  Name: macro name
  Parameters:
    Key: value

參數

名稱

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

參數

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

傳回值

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

範例

以下範例呼叫 AWS::Include 轉換，其中指定將擷取範本程式碼片段的來源位置傳入 InputValue 參數中。

JSON

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

YAML

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

支援的函數

無。

CloudFormation 將包含在中的任何內部函數調用作為文字字符串傳遞Fn::Transform給指定的宏。如需更多詳細資訊，請參閱 CloudFormation 巨集函數介面。