Pseudoparameter-Referenz

Pseudo-Parameter sind Parameter, die von AWS CloudFormation vordefiniert sind. 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:

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

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 Benachrichtigungen Amazon Resource Names (ARNs) für den aktuellen Stack zurück.

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

"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" ]
      }]
   }
}

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 als wahr ausgewertet wird, CloudFormation wird der DBSnapshotName Parameterwert für die DBSnapshotIdentifier Eigenschaft verwendet. Wenn die Bedingung als falsch ausgewertet wird, CloudFormation wird die DBSnapshotIdentifier Eigenschaft entfernt.

"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"}
      ]
    }
  }
}

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 aws die Partition. Für Ressourcen in anderen Partitionen lautet die Partition aws-partitionname. Zum Beispiel ist die Partition für Ressourcen in der Region China (Peking und Ningxia) aws-cn und die Partition für Ressourcen in der Region AWS GovCloud (USA West). 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.