Obtenir des AWS valeurs à l'aide de pseudo-paramètres - AWS CloudFormation
SyntaxeexemplePseudo-paramètres disponibles

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Obtenir des AWS valeurs à l'aide de pseudo-paramètres

Les pseudo-paramètres sont prédéfinis par votre modèle CloudFormation et ne nécessitent pas de déclaration dans celui-ci. Utilisez-les avec les fonctions Sub intrinsèques Ref ou intrinsèques pour accéder aux informations contextuelles relatives à vos données Compte AWS, à votre région et à d'autres données contextuelles, au lieu de coder des valeurs en dur dans votre modèle.

Syntaxe

Pour utiliser des pseudo-paramètres avec la fonction Ref intrinsèque, la syntaxe de base est la suivante :

JSON

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

YAML

!Ref AWS::PseudoParameter

Pour utiliser des pseudo-paramètres avec la fonction Sub intrinsèque, la syntaxe de base est la suivante :

JSON

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

YAML

!Sub '${AWS::PseudoParameter}'

exemple

L'extrait suivant affecte la valeur du pseudo-paramètre AWS::Region à une valeur de sortie :

JSON

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

YAML

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

Pseudo-paramètres disponibles

AWS::AccountId

Renvoie l' Compte AWS ID du compte dans lequel la pile est créée, par exemple123456789012.

AWS::NotificationARNs

Renvoie la liste des notifications Amazon Resource Names (ARNs) pour la pile actuelle.

Pour obtenir un seul ARN dans la liste, utilisezFn::Select. Pour plus d'informations, consultez la Fn::Selectréférence.

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

Supprime la propriété de ressource correspondante lorsqu'elle est spécifiée comme valeur de retour dans la fonction intrinsèque Fn::If.

Par exemple, vous pouvez utiliser le paramètre AWS::NoValue lorsque vous souhaitez employer un instantané pour une instance de base de données Amazon RDS seulement si un ID d'instantané est fourni. Si la UseDBSnapshot condition est vraie, CloudFormation utilise la valeur du DBSnapshotName paramètre de la DBSnapshotIdentifier propriété. Si la condition est fausse, la DBSnapshotIdentifier propriété CloudFormation est supprimée.

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

Renvoie la partition dans laquelle se trouve la ressource. En standard Régions AWS, la partition estaws. Pour les ressources dans d'autres partitions, la partition est aws-partitionname. Par exemple, la partition pour les ressources dans les régions de Chine (Pékin et Ningxia) est aws-cn et la partition pour les ressources dans la région AWS GovCloud (ouest des États-Unis) est. aws-us-gov

AWS::Region

Renvoie une chaîne représentant la région dans laquelle la ressource globale est créée, comme us-west-2.

AWS::StackId

Renvoie l'ID de la pile comme indiqué avec la commande create-stack (arn:aws:cloudformation:us-west-2:123456789012:stack/teststack/51af3dc0-da77-11e4-872e-1234567db123, par exemple).

AWS::StackName

Renvoie le nom de la pile comme indiqué avec la commande create-stack (teststack, par exemple).

AWS::URLSuffix

Renvoie le suffixe pour un domaine. Le suffixe est en général amazonaws.com, mais il peut varier d'une région à l'autre. Par exemple, le suffixe pour la région Chine (Pékin) est amazonaws.com.cn.