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::Sub
Mit der intrinsischen FunktionFn::Sub
können Sie Variablen in einer Eingabezeichenfolge mit Werten ersetzen, die Sie angeben. In Ihren Vorlagen können Sie diese Funktion verwenden, um Befehle oder Ausgaben mit Werten zu erstellen, die erst verfügbar sind, wenn Sie einen Stack erstellen oder aktualisieren.
Deklaration
In den folgenden Abschnitten wird die Syntax der Funktion erläutert.
JSON
{ "Fn::Sub" : [
String
, {Var1Name
:Var1Value
,Var2Name
:Var2Value
} ] }
Wenn Sie nur Vorlagenparameter, logische Ressourcen-IDs oder Ressourcenattribute im Parameter
ersetzen, müssen Sie keine Variablenzuweisung angeben.String
{ "Fn::Sub" :
String
}
YAML
Syntax für den vollständigen Funktionsnamen:
Fn::Sub: -
String
-Var1Name
:Var1Value
Var2Name
:Var2Value
Syntax für die Kurzform:
!Sub -
String
-Var1Name
:Var1Value
Var2Name
:Var2Value
Wenn Sie nur Vorlagenparameter, logische Ressourcen-IDs oder Ressourcenattribute im Parameter
ersetzen, müssen Sie keine Variablenzuweisung angeben.String
Syntax für den vollständigen Funktionsnamen:
Fn::Sub:
String
Syntax für die Kurzform:
!Sub
String
Parameter
String
-
Eine Zeichenfolge mit Variablen, die zur Laufzeit durch ihre zugehörigen Werte AWS CloudFormation ersetzt werden. Schreibt Variablen als
${
. Variablen können Vorlagenparameternamen, logische Ressourcen-IDs, Ressourcenattribute oder Variablen in einer Schlüssel-Wert-Zuweisung sein. Wenn Sie nur Vorlagenparameternamen, logische Ressourcen-IDs und Ressourcenattribute angeben, geben Sie keine Schlüssel-Wert-Zuweisung an.MyVarName
}Wenn Sie Vorlagenparameternamen oder logische Ressourcen-IDs angeben, werden dieselben Werte CloudFormation zurückgegeben
${InstanceTypeParameter}
, als ob Sie dieRef
systeminterne Funktion verwendet hätten. Wenn Sie Ressourcenattribute angeben, z. B. werden dieselben Werte CloudFormation zurückgegeben${MyInstance.PublicIp}
, als ob Sie dieFn::GetAtt
systeminterne Funktion verwendet hätten.Um ein Dollarzeichen und geschweifte Klammern (
${}
) wörtlich zu schreiben, fügen Sie nach der geöffneten geschweiften Klammer ein Ausrufezeichen (!
) hinzu, z. B.${!
CloudFormationLiteral
}${
löst diesen Text auf als.Literal
} VarName
-
Der Name einer Variablen, die Sie im Parameter
String
eingefügt haben. VarValue
-
Der Wert, der zur CloudFormation Laufzeit den zugehörigen Variablennamen ersetzt.
Rückgabewert
CloudFormation gibt die ursprüngliche Zeichenfolge zurück und ersetzt alle Variablen durch die Werte.
Beispiele
Das folgende Beispiele zeigt, wie die Fn::Sub
-Funktion verwendet wird.
Fn::Sub
Ohne eine Schlüssel-Wert-Map verwenden
In diesem einfachen Beispiel wird die Beschreibung der InstanceSecurityGroup
Ressource dynamisch mit dem AWS::StackName
Pseudo-Parameter erstellt. Wenn der Stack-Name beispielsweise "VPC-EC2-ALB-Stack" lautet, lautet die resultierende Beschreibung "SSH security group for VPC-EC2-ALB-Stack“.
JSON
"InstanceSecurityGroup" : { "Type" : "AWS::EC2::SecurityGroup", "Properties" : { "GroupDescription" : {"Fn::Sub": "SSH security group for ${AWS::StackName}"} }}
YAML
InstanceSecurityGroup: Type: AWS::EC2::SecurityGroup Properties: GroupDescription: !Sub "SSH security group for ${AWS::StackName}"
Wird Fn::Sub
mit einer Key-Value-Map verwendet
In diesem Beispiel wird der Name der WWWBucket
Ressource dynamisch mit einer Key-Value-Map erstellt. Die Fn::Sub
Funktion ersetzt ${Domain}
die Eingabezeichenfolge www.${Domain}
durch den Wert einer Ref
Funktion, die auf den RootDomainName
Parameter verweist, der in derselben Stack-Vorlage definiert ist. Wenn der Stammdomänenname beispielsweise "mydomain.com" lautet, lautet der resultierende Name für diese Ressource "www.mydomain.com“.
JSON
"WWWBucket":{ "Type":"AWS::S3::Bucket", "Properties":{ "BucketName":{ "Fn::Sub":[ "www.${Domain}", { "Domain":{ "Ref":"RootDomainName" } } ] } } }
YAML
WWWBucket: Type: AWS::S3::Bucket Properties: BucketName: !Sub - 'www.${Domain}' - Domain: !Ref RootDomainName
Verwenden Sie mehrere Variablen, um ARNs zu erstellen
Im folgenden Beispiel wird Fn::Sub
mit den AWS::AccountId
Pseudo-Parametern AWS::Region
und und der logischen vpc
Ressourcen-ID ein Amazon-Ressourcenname (ARN) für eine VPC erstellt.
JSON
{ "Fn::Sub": "arn:aws:ec2:${AWS::Region}:${AWS::AccountId}:vpc/${vpc}" }
YAML
!Sub 'arn:aws:ec2:${AWS::Region}:${AWS::AccountId}:vpc/${vpc}'
Übergeben Sie Parameterwerte in Benutzerdatenskripts
In dem folgenden Beispiel werden die Pseudoparameter Fn::Sub
und AWS::StackName
mit AWS::Region
zur Laufzeit mit dem tatsächlichen Stack-Namen und der Region ersetzt.
JSON
Zur besseren Lesbarkeit werden die einzelnen Befehle im JSON-Beispiel mit der Fn::Join
-Funktion voneinander getrennt, sodass nicht das gesamte Benutzerdaten-Skript in einem einzelnen Zeichenfolgewert angegeben ist.
"UserData": { "Fn::Base64": { "Fn::Join": ["\n", [ "#!/bin/bash -xe", "yum update -y aws-cfn-bootstrap", { "Fn::Sub": "/opt/aws/bin/cfn-init -v --stack ${AWS::StackName} --resource LaunchConfig --configsets wordpress_install --region ${AWS::Region}" }, { "Fn::Sub": "/opt/aws/bin/cfn-signal -e $? --stack ${AWS::StackName} --resource WebServerGroup --region ${AWS::Region}" }]] }}
YAML
Im YAML-Beispiel wird ein Literal-Block verwendet, um ein Benutzerdaten-Skript anzugeben.
UserData: Fn::Base64: !Sub | #!/bin/bash -xe yum update -y aws-cfn-bootstrap /opt/aws/bin/cfn-init -v --stack ${AWS::StackName} --resource LaunchConfig --configsets wordpress_install --region ${AWS::Region} /opt/aws/bin/cfn-signal -e $? --stack ${AWS::StackName} --resource WebServerGroup --region ${AWS::Region}
Unterstützte Funktionen
Für den String
-Parameter können Sie nicht jede beliebige Funktion verwenden. Sie müssen einen Zeichenfolgenwert angeben.
Für die Parameter VarName
und VarValue
stehen Ihnen die folgenden Funktionen zur Verfügung: