Referencia de pseudoparámetros - AWS CloudFormation

Referencia de pseudoparámetros

Los pseudoparámetros son parámetros predefinidos por AWS CloudFormation. No los declara en su plantilla. Utilícelos de la misma forma que utilizaría un parámetro, como el argumento para la función Ref.

Ejemplo

El siguiente fragmento de código asigna el valor del pseudoparámetro AWS::Region a un valor de salida:

JSON

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

YAML

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

AWS::AccountId

Devuelve el ID de cuenta de AWS de la cuenta en la que se está creando la pila como, por ejemplo 123456789012.

AWS::NotificationARNs

Devuelve la lista de Nombres de recursos de Amazon (ARN) de notificación para la pila actual.

Para obtener un único ARN de la lista, utilice 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

Elimina la propiedad de recurso correspondiente cuando se especifica como valor devuelto en la función intrínseca Fn::If.

Por ejemplo, puede utilizar el parámetro AWS::NoValue cuando desea utilizar una instantánea para una instancia de base de datos de Amazon RDS solo si se proporciona un ID de instantánea. Si la condición UseDBSnapshot se evalúa como true, CloudFormation utiliza el valor del parámetro DBSnapshotName para la propiedad DBSnapshotIdentifier. Si se evalúa la condición como false, CloudFormation elimina la propiedad DBSnapshotIdentifier.

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

Devuelve la partición en la que se encuentra el recurso. Para las regiones estándar de AWS, la partición es aws. Para recursos en otras particiones, la partición es aws-partitionname. Por ejemplo, la partición de los recursos de la región China (Pekín y Ningxia) es aws-cn y la partición de los recursos en la región AWS GovCloud (US-West) es aws-us-gov.

AWS::Region

Devuelve una cadena que representa la región en la que se crea el recurso que abarca, como por ejemplo us-west-2.

AWS::StackId

Devuelve el ID de la pila según se especifica con el comando aws cloudformation create-stack, como por ejemplo arn:aws:cloudformation:us-west-2:123456789012:stack/teststack/51af3dc0-da77-11e4-872e-1234567db123.

AWS::StackName

Devuelve el nombre de la pila según se especifica con el comando aws cloudformation create-stack, como por ejemplo teststack.

AWS::URLSuffix

Devuelve el sufijo de un dominio. El sufijo suele ser amazonaws.com, pero puede variar según la región. Por ejemplo, el sufijo para la región China (Pekín) es amazonaws.com.cn.