Fn::Transform - AWS CloudFormation
DeklarationParameterRückgabewertBeispieleUnterstützte Funktionen

Dies ist das neue CloudFormation Template Reference Guide. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im AWS CloudFormationBenutzerhandbuch.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 Verwendung von CloudFormation-Makros für die benutzerdefinierte Verarbeitung von Vorlagen im AWS CloudFormation Benutzerhandbuch.

Sie können mit Fn::Transform auch die Transformation AWS::Include-Transformation aufrufen, bei der es sich um ein Makro handelt, das von 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.

Parameters

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

Unterstützte Funktionen

Keine.

CloudFormation übergibt alle in Fn::Transform enthaltenen intrinsischen Funktionsaufrufe an das angegebene Makro als Literalzeichenfolgen.