Esta es la nueva *Guía de referencia de plantillas de CloudFormation*. Actualice sus marcadores y enlaces. Para obtener ayuda sobre cómo empezar a usar CloudFormation, consulte la [Guía del usuario de AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
# `Condition`Atributo
Para crear recursos en CloudFormation basándose en condiciones, primero declare su condición en la sección `Conditions` de la plantilla. A continuación, utilice la clave `Condition` junto con el ID lógico de la condición como atributo del recurso. CloudFormation crea el recurso únicamente cuando la condición se evalúa como true. Esto permite controlar la creación de recursos en función de criterios o parámetros específicos que defina en la plantilla.
Si es la primera vez que utiliza condiciones en sus plantillas, recomendamos consultar primero el tema de [sintaxis de las condiciones de las plantillas de CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/conditions-section-structure.html) en la *Guía del usuario de AWS CloudFormation*.
**nota**
Si no se crea un recurso con una condición, tampoco se crean los recursos que dependan de ese recurso, independientemente de sus propias condiciones.
## Ejemplo
La siguiente plantilla contiene un recurso de bucket de Amazon S3 con un atributo `Condition`. El bucket solo se crea si la condición `CreateBucket` se evalúa como `true`.
### JSON
```
{
"AWSTemplateFormatVersion" : "2010-09-09",
"Parameters" : {
"EnvType" : {
"Type" : "String",
"AllowedValues" : ["prod", "dev"],
"Default" : "dev",
"Description" : "Environment type"
}
},
"Conditions" : {
"CreateBucket" : {"Fn::Equals" : [{"Ref" : "EnvType"}, "prod"]}
},
"Resources" : {
"MyBucket" : {
"Type" : "AWS::S3::Bucket",
"Condition" : "CreateBucket",
"Properties" : {
"BucketName" : {"Fn::Join" : ["-", ["mybucket", {"Ref" : "EnvType"}]]}
}
}
}
}
```
### YAML
```
1. AWSTemplateFormatVersion: 2010-09-09
2. Parameters:
3. EnvType:
4. Type: String
5. AllowedValues:
6. - prod
7. - dev
8. Default: dev
9. Description: Environment type
10. Conditions:
11. CreateBucket: !Equals [!Ref EnvType, prod]
12. Resources:
13. MyBucket:
14. Type: AWS::S3::Bucket
15. Condition: CreateBucket
16. Properties:
17. BucketName: !Sub mybucket-${EnvType}
```
## Uso de varias condiciones
Puede combinar varias condiciones mediante funciones intrínsecas como [`Fn::And`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-and), [`Fn::Or`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-or) y [`Fn::Not`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-not) para crear una lógica condicional más compleja.
### JSON
```
{
"AWSTemplateFormatVersion" : "2010-09-09",
"Parameters" : {
"EnvType" : {
"Type" : "String",
"AllowedValues" : ["prod", "test", "dev"],
"Default" : "dev",
"Description" : "Environment type"
},
"CreateResources" : {
"Type" : "String",
"AllowedValues" : ["true", "false"],
"Default" : "true",
"Description" : "Create resources flag"
}
},
"Conditions" : {
"IsProd" : {"Fn::Equals" : [{"Ref" : "EnvType"}, "prod"]},
"IsTest" : {"Fn::Equals" : [{"Ref" : "EnvType"}, "test"]},
"CreateResourcesFlag" : {"Fn::Equals" : [{"Ref" : "CreateResources"}, "true"]},
"CreateProdResources" : {"Fn::And" : [{"Condition" : "IsProd"}, {"Condition" : "CreateResourcesFlag"}]},
"CreateTestOrDevResources" : {"Fn::And" : [{"Fn::Or" : [{"Condition" : "IsTest"}, {"Fn::Not" : [{"Condition" : "IsProd"}]}]}, {"Condition" : "CreateResourcesFlag"}]}
},
"Resources" : {
"ProdBucket" : {
"Type" : "AWS::S3::Bucket",
"Condition" : "CreateProdResources",
"Properties" : {
"BucketName" : {"Fn::Join" : ["-", ["prod-bucket", {"Ref" : "AWS::StackName"}]]}
}
},
"TestDevBucket" : {
"Type" : "AWS::S3::Bucket",
"Condition" : "CreateTestOrDevResources",
"Properties" : {
"BucketName" : {"Fn::Join" : ["-", [{"Ref" : "EnvType"}, "bucket", {"Ref" : "AWS::StackName"}]]}
}
}
}
}
```
### YAML
```
1. AWSTemplateFormatVersion: 2010-09-09
2. Parameters:
3. EnvType:
4. Type: String
5. AllowedValues:
6. - prod
7. - test
8. - dev
9. Default: dev
10. Description: Environment type
11. CreateResources:
12. Type: String
13. AllowedValues:
14. - 'true'
15. - 'false'
16. Default: 'true'
17. Description: Create resources flag
18. Conditions:
19. IsProd: !Equals [!Ref EnvType, prod]
20. IsTest: !Equals [!Ref EnvType, test]
21. CreateResourcesFlag: !Equals [!Ref CreateResources, 'true']
22. CreateProdResources: !And
23. - !Condition IsProd
24. - !Condition CreateResourcesFlag
25. CreateTestOrDevResources: !And
26. - !Or
27. - !Condition IsTest
28. - !Not [!Condition IsProd]
29. - !Condition CreateResourcesFlag
30. Resources:
31. ProdBucket:
32. Type: AWS::S3::Bucket
33. Condition: CreateProdResources
34. Properties:
35. BucketName: !Sub prod-bucket-${AWS::StackName}
36. TestDevBucket:
37. Type: AWS::S3::Bucket
38. Condition: CreateTestOrDevResources
39. Properties:
40. BucketName: !Sub ${EnvType}-bucket-${AWS::StackName}
```
## Uso de `AWS::AccountId` en condiciones
Puede utilizar pseudoparámetros como `AWS::AccountId` en sus condiciones para crear recursos en función de la Cuenta de AWS en donde se implemente la pila. Esto resulta útil para implementaciones con varias cuentas o cuando se necesita excluir cuentas específicas de la recepción de determinados recursos. Para obtener más información sobre los pseudoparámetros, consulte [Obtención de valoresde AWS mediante pseudoparámetros](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/pseudo-parameter-reference.html) en la *Guía del usuario de AWS CloudFormation*.
### JSON
```
{
"AWSTemplateFormatVersion" : "2010-09-09",
"Conditions" : {
"ExcludeAccount1" : {"Fn::Not" : [{"Fn::Equals" : [{"Ref" : "AWS::AccountId"}, "111111111111"]}]},
"ExcludeAccount2" : {"Fn::Not" : [{"Fn::Equals" : [{"Ref" : "AWS::AccountId"}, "222222222222"]}]},
"ExcludeBothAccounts" : {"Fn::And" : [{"Condition" : "ExcludeAccount1"}, {"Condition" : "ExcludeAccount2"}]}
},
"Resources" : {
"StandardBucket" : {
"Type" : "AWS::S3::Bucket",
"Properties" : {
"BucketName" : {"Fn::Join" : ["-", ["standard-bucket", {"Ref" : "AWS::StackName"}]]}
}
},
"RestrictedResource" : {
"Type" : "AWS::SNS::Topic",
"Condition" : "ExcludeBothAccounts",
"Properties" : {
"TopicName" : {"Fn::Join" : ["-", ["restricted-topic", {"Ref" : "AWS::StackName"}]]}
}
}
}
}
```
### YAML
```
1. AWSTemplateFormatVersion: 2010-09-09
2. Conditions:
3. ExcludeAccount1: !Not [!Equals [!Ref 'AWS::AccountId', '111111111111']]
4. ExcludeAccount2: !Not [!Equals [!Ref 'AWS::AccountId', '222222222222']]
5. ExcludeBothAccounts: !And
6. - !Condition ExcludeAccount1
7. - !Condition ExcludeAccount2
8. Resources:
9. StandardBucket:
10. Type: AWS::S3::Bucket
11. Properties:
12. BucketName: !Sub standard-bucket-${AWS::StackName}
13. RestrictedResource:
14. Type: AWS::SNS::Topic
15. Condition: ExcludeBothAccounts
16. Properties:
17. TopicName: !Sub restricted-topic-${AWS::StackName}
```