A função Fn::If retorna um de dois valores com base no resultado (verdadeiro ou falso) de uma condição especificada.
Nota
As seções Resources e Outputs dos modelos aceitam Fn::If. Use o pseudoparâmetro ALIYUN::NoValue como valor de retorno para remover uma propriedade.
Declaração
-
JSON
{ "Fn::If": [ "condition_name", "value_if_true", "value_if_false" ] } -
YAML
-
Sintaxe do nome completo da função:
Fn::If: - condition_name - value_if_true - value_if_false -
Sintaxe da forma abreviada:
!If [condition_name, value_if_true, value_if_false]
-
Parâmetros
condition_name: nome de uma condição definida na seção Conditions.value_if_true: valor retornado quando a condição for avaliada como verdadeira.value_if_false: valor retornado quando a condição for avaliada como falsa.
Exemplos
O exemplo a seguir determina a criação de discos de dados com base nos parâmetros de entrada:
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
EnvType:
Default: pre
Type: String
Conditions:
CreateDisk:
!Equals
- prod
- !Ref EnvType
Resources:
WebServer:
Type: ALIYUN::ECS::Instance
Properties:
DiskMappings:
!If
- CreateDisk
- - Category: cloud_efficiency
DiskName: FirstDataDiskName
Size: 40
- Category: cloud_ssd
DiskName: SecondDataDiskName
Size: 40
- !Ref ALIYUN::NoValue{
"ROSTemplateFormatVersion": "2015-09-01",
"Parameters": {
"EnvType": {
"Default": "pre",
"Type": "String"
}
},
"Conditions": {
"CreateDisk": {
"Fn::Equals": [
"prod",
{
"Ref": "EnvType"
}
]
}
},
"Resources": {
"WebServer": {
"Type": "ALIYUN::ECS::Instance",
"Properties": {
"DiskMappings": {
"Fn::If": [
"CreateDisk",
[
{
"Category": "cloud_efficiency",
"DiskName": "FirstDataDiskName",
"Size": 40
},
{
"Category": "cloud_ssd",
"DiskName": "SecondDataDiskName",
"Size": 40
}
],
{
"Ref": "ALIYUN::NoValue"
}
]
}
}
}
}
}