Ottieni AWS valori usando pseudo parametri

Gli pseudo parametri sono predefiniti CloudFormation e non richiedono alcuna dichiarazione nel modello. Utilizzateli con le Ref funzioni Sub intrinseche per accedere alle informazioni contestuali relative all'utente Account AWS, alla regione e ad altri dati contestuali, anziché codificare i valori fissi nel modello.

Sintassi

Per utilizzare gli pseudo parametri con la funzione intrinseca, la sintassi di base è: Ref

{ "Ref" : "AWS::PseudoParameter" }

!Ref AWS::PseudoParameter

Per utilizzare gli pseudoparametri con la funzione Sub intrinseca, la sintassi di base è:

{ "Fn::Sub" : "${AWS::PseudoParameter}" }

!Sub '${AWS::PseudoParameter}'

Esempio

Il seguente frammento assegna il valore dello pseudoparametro AWS::Region a un valore di output:

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

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

Pseudoparametri disponibili

AWS::AccountId

Restituisce l' Account AWS ID dell'account in cui viene creato lo stack, ad esempio. 123456789012

AWS::NotificationARNs

Restituisce l'elenco delle notifiche Amazon Resource Names (ARNs) per lo stack corrente.

Per ottenere un singolo ARN dall'elenco, usa. Fn::Select Per ulteriori informazioni, consulta il Fn::Selectriferimento.

"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

Rimuove la proprietà della risorsa corrispondente quando specificata come valore restituito nella funzione intrinseca Fn::If.

Ad esempio, puoi utilizzare il parametro AWS::NoValue quando desideri utilizzare una snapshot per un'istanza database Amazon RDS solo se un'ID snapshot viene fornito. Se la UseDBSnapshot condizione risulta vera, CloudFormation utilizza il valore del DBSnapshotName parametro per la DBSnapshotIdentifier proprietà. Se la condizione risulta falsa, CloudFormation rimuove la DBSnapshotIdentifier proprietà.

"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

Restituisce la partizione in cui si trova la risorsa. Per lo standard Regioni AWS, la partizione è. aws Per risorse in altre partizioni, la partizione è aws-partitionname. Ad esempio, la partizione per le risorse nelle regioni della Cina (Pechino e Ningxia) è aws-cn e la partizione per le risorse nella regione AWS GovCloud (Stati Uniti occidentali) è. aws-us-gov

AWS::Region

Restituisce una stringa che rappresenta la Regione in cui la risorsa comprendente è in fase di creazione, ad esempio us-west-2.

AWS::StackId

Restituisce l'ID dello stack come specificato nel comando create-stack, ad esempio arn:aws:cloudformation:us-west-2:123456789012:stack/teststack/51af3dc0-da77-11e4-872e-1234567db123.

AWS::StackName

Restituisce il nome dello stack come specificato nel comando create-stack, ad esempio teststack.

AWS::URLSuffix

Restituisce il suffisso per un dominio. Il suffisso è in genere amazonaws.com, ma può variare in base alla Regione. Ad esempio, il suffisso per la Regione Cina (Pechino) è amazonaws.com.cn.