Fn::Transform

Die intrinsische Funktion Fn::Transform spezifiziert ein Makro, um eine benutzerdefinierte Verarbeitung auf einem Teil einer Stack-Vorlage durchzuführen. Verwenden Sie Makros, um benutzerdefinierte Verarbeitungen von Vorlagen durchzuführen – von einfachen Aktionen wie Suchen und Ersetzen bis hin zu umfangreichen Transformationen ganzer Vorlagen. Weitere Informationen finden Sie unter Verwenden von AWS CloudFormation Makros zur benutzerdefinierten Verarbeitung von Vorlagen.

Sie können mit Fn::Transform auch die Transformation AWS::Include-Transformation aufrufen, bei der es sich um ein Makro handelt, das von AWS CloudFormation gehostet wird.

Deklaration

JSON

Syntax für den vollständigen Funktionsnamen:

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

Syntax für die Kurzform:

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

YAML

Syntax für den vollständigen Funktionsnamen:

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

Syntax für die Kurzform:

!Transform
  Name: macro name
  Parameters:
    Key: value

Parameter

Name

Der Name des Makros, das Sie für die Verarbeitung verwenden möchten.

Parameter

Die Listenparameter, die als Schlüssel-Wert-Paare angegeben sind, werden an das Makro übergeben.

Rückgabewert

Der bearbeitete Vorlagenausschnitt, der in die bearbeitete Stack-Vorlage aufgenommen werden soll.

Beispiele

Das folgende Beispiel ruft die AWS::Include-Transformation auf und gibt an, dass im Parameter InputValue der Ort übergeben wird, an dem ein Vorlagenausschnitt abgerufen werden soll.

JSON

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

YAML

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

Das folgende Beispiel ruft die Transformation AWS::Include auf und gibt an, dass sich der Ort, an dem ein Vorlagenausschnitt abgerufen werden soll, in der RegionMap-Zuordnung unter dem Schlüssel us-east-1 und dem verschachtelten Schlüssel s3Location befindet.

JSON

{
    "Fn::Transform": {
        "Name": "AWS::Include",
        "Parameters": {
            "Location": {
                "Fn::FindInMap": [
                    "RegionMap",
                    "us-east-1",
                    "s3Location"
                ]
            }
        }
    }
}

YAML

!Transform
  Name: AWS::Include
  Parameters:
    Location: !FindInMap
      - RegionMap
      - us-east-1
      - s3Location

Unterstützte Funktionen

Keine.

CloudFormation übergibt alle in Fn::Transform enthaltenen intrinsischen Funktionsaufrufe an das angegebene Makro als Literalzeichenfolgen. Weitere Informationen finden Sie unter AWS CloudFormation -Makro-Funktionsschnittstelle.