Fn::Split

Verwenden Sie die intrinsische Fn::Split-Funktion, um eine Zeichenfolge in eine Liste von Zeichenfolgen aufzuteilen, sodass Sie aus der fertigen Liste ein Element wählen können. Geben Sie den Speicherort der Aufteilungen mit einem Trennzeichen an, z. B. , (ein Komma). Nachdem Sie eine Zeichenfolge aufgeteilt haben, verwenden Sie die Fn::Select-Funktion, um ein bestimmtes Element zu wählen.

Wenn beispielsweise eine durch ein Komma getrennte Zeichenfolge von Subnetz-IDs in Ihre Stack-Vorlage importiert wird, können Sie die Zeichenfolge an jedem Komma teilen. Verwenden Sie aus der Liste der Subnetz-IDs die intrinsische Fn::Select-Funktion, um für eine Ressource eine Subnetz-ID anzugeben.

Deklaration

JSON

{ "Fn::Split" : [ "delimiter", "source string" ] }

YAML

Syntax für den vollständigen Funktionsnamen:

Fn::Split: [ delimiter, source string ]

Syntax für die Kurzform:

!Split [ delimiter, source string ]

Parameter

Sie müssen beide Parameter angeben.

delimiter

Ein Zeichenfolgewert, der bestimmt, an welcher Stelle die Quell-Zeichenfolge aufgeteilt wird.

Quell-Zeichenfolge

Der Zeichenfolgewert, den Sie aufteilen möchten.

Rückgabewert

Eine Liste von Zeichenfolgewerten.

Beispiele

Das folgende Beispiele zeigt das Verhalten der Fn::Split-Funktion.

Einfache Liste

Im folgenden Beispiel wird eine Zeichenfolge an jedem vertikalen Balken (|) aufgeteilt. Die Funktion gibt ["a", "b", "c"] zurück.

JSON

{ "Fn::Split" : [ "|" , "a|b|c" ] }

YAML

!Split [ "|" , "a|b|c" ]

 

Liste mit leeren Zeichenfolgewerten

Wenn Sie eine Zeichenfolge mit aufeinanderfolgenden Trennzeichen aufteilen, enthält die resultierende Liste eine leere Zeichenfolge. Im folgenden Beispiel wird eine Zeichenfolge mit zwei aufeinanderfolgende Trennzeichen und einem angehängten Trennzeichen aufgeteilt. Die Funktion gibt ["a", "", "c", ""] zurück.

JSON

{ "Fn::Split" : [ "|" , "a||c|" ] }

YAML

!Split [ "|" , "a||c|" ]

 

Aufteilen eines importierten Ausgabewerts

Im folgenden Beispiel wird ein importierter Ausgabewert aufgeteilt und anschließend das dritte Element aus der resultierenden Liste Subnetz-IDs wie in der Funktion Fn::Select festgelegt ausgewählt.

JSON

{ "Fn::Select" : [ "2", { "Fn::Split": [",", {"Fn::ImportValue": "AccountSubnetIDs"}]}] }

YAML

!Select [2, !Split [",", !ImportValue AccountSubnetIDs]]

Unterstützte Funktionen

Für das Fn::Split-Trennzeichen können Sie nicht jede beliebige Funktion verwenden. Sie müssen einen Zeichenfolgenwert angeben.

Für die Werteliste Fn::Split können Sie die folgenden Funktionen verwenden:

• Fn::Base64

• Fn::FindInMap

• Fn::GetAtt

• Fn::GetAZs

• Fn::If

• Fn::ImportValue

• Fn::Join

• Fn::Select

• Fn::Sub

• Ref