Pseudoparameter-Referenz - AWS CloudFormation

Pseudoparameter-Referenz

Pseudoparameter sind Parameter, die von AWS CloudFormation vordefiniert werden. Sie deklarieren sie nicht in Ihrer Vorlage. Verwenden Sie sie auf dieselbe Weise wie einen Parameter, als Argument für die Ref Funktion.

Beispiel

Der folgende Ausschnitt weist den Wert des Pseudoparameter AWS::Region zu einem Ausgabewert zu:

JSON

"Outputs" : { "MyStacksRegion" : { "Value" : { "Ref" : "AWS::Region" } } }

YAML

Outputs: MyStacksRegion: Value: !Ref "AWS::Region"

AWS::AccountId

Gibt die AWS-Konto-ID des Kontos zurück, in dem der Stack erstellt wird, z. B. 123456789012.

AWS::NotificationARNs

Gibt die Liste der Benachrichtigung der Amazon-Ressourcennamen (ARNs) für den aktuellen Stack zurück.

Um einen einzelne ARN aus der Liste zu bekommen, verwenden Sie Fn::Select.

JSON

"myASGrpOne" : { "Type" : "AWS::AutoScaling::AutoScalingGroup", "Version" : "2009-05-15", "Properties" : { "AvailabilityZones" : [ "us-east-1a" ], "LaunchConfigurationName" : { "Ref" : "MyLaunchConfiguration" }, "MinSize" : "0", "MaxSize" : "0", "NotificationConfigurations" : [{ "TopicARN" : { "Fn::Select" : [ "0", { "Ref" : "AWS::NotificationARNs" } ] }, "NotificationTypes" : [ "autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_LAUNCH_ERROR" ] }] } }

YAML

myASGrpOne: Type: AWS::AutoScaling::AutoScalingGroup Version: '2009-05-15' Properties: AvailabilityZones: - "us-east-1a" LaunchConfigurationName: Ref: MyLaunchConfiguration MinSize: '0' MaxSize: '0' NotificationConfigurations: - TopicARN: Fn::Select: - '0' - Ref: AWS::NotificationARNs NotificationTypes: - autoscaling:EC2_INSTANCE_LAUNCH - autoscaling:EC2_INSTANCE_LAUNCH_ERROR

AWS::NoValue

Entfernt die entsprechende Ressourceneigenschaft, wenn als Rückgabewert in der intrinsischen Funktion Fn::If angegeben.

Sie können beispielsweise den Parameter AWS::NoValue verwenden, wenn Sie einen Snapshot für eine Amazon RDS DB-Instance verwenden möchten nur wenn eine Snapshot-ID ist bereitgestellt ist. Wenn die ‌UseDBSnapshot-Bedingung „true“ ergibt, verwendet CloudFormation den Parameterwert DBSnapshotName für die DBSnapshotIdentifier-Eigenschaft. Wenn die Bedingung „false“ ergibt, entfernt CloudFormation die DBSnapshotIdentifier-Eigenschaft.

JSON

"MyDB" : { "Type" : "AWS::RDS::DBInstance", "Properties" : { "AllocatedStorage" : "5", "DBInstanceClass" : "db.t2.small", "Engine" : "MySQL", "EngineVersion" : "5.5", "MasterUsername" : { "Ref" : "DBUser" }, "MasterUserPassword" : { "Ref" : "DBPassword" }, "DBParameterGroupName" : { "Ref" : "MyRDSParamGroup" }, "DBSnapshotIdentifier" : { "Fn::If" : [ "UseDBSnapshot", {"Ref" : "DBSnapshotName"}, {"Ref" : "AWS::NoValue"} ] } } }

YAML

MyDB: Type: AWS::RDS::DBInstance Properties: AllocatedStorage: '5' DBInstanceClass: db.t2.small Engine: MySQL EngineVersion: '5.5' MasterUsername: Ref: DBUser MasterUserPassword: Ref: DBPassword DBParameterGroupName: Ref: MyRDSParamGroup DBSnapshotIdentifier: Fn::If: - UseDBSnapshot - Ref: DBSnapshotName - Ref: AWS::NoValue

AWS::Partition

Gibt die Partition zurück, in der sich die Ressource befindet. Für AWS-Standardregionen lautet die Partition aws. Für Ressourcen in anderen Partitionen lautet die Partition aws-partitionname. So ist beispielsweise die Aufteilung der Ressourcen in der Region China (Peking und Ningxia) aws-cn und die Aufteilung der Ressourcen in der Region AWS GovCloud (US-West) ist aws-us-gov.

AWS::Region

Gibt eine Zeichenfolge zurück, die die Region repräsentiert, in der die umfassende Ressource erstellt wird, z. B. us-west-2.

AWS::StackId

Gibt die ID des Stacks mit dem angegebenen Befehl aws cloudformation create-stack, z. B. arn:aws:cloudformation:us-west-2:123456789012:stack/teststack/51af3dc0-da77-11e4-872e-1234567db123 zurück.

AWS::StackName

Gibt den Namen des Stacks mit dem angegebenen Befehl aws cloudformation create-stack, z. B. teststack zurück.

AWS::URLSuffix

Gibt das Suffix für eine Domäne zurück. Das Suffix lautet normalerweise amazonaws.com, kann aber in Abhängigkeit von der Region variieren. Das Suffix für die Region China (Peking) lautet beispielsweise amazonaws.com.cn.