全部产品
Search
文档中心

资源编排:Fn::If

更新时间:Feb 02, 2024

调用内部函数Fn::If,如果指定的条件计算为true,则返回一个值;如果指定的条件计算为false,则返回另一个值。

说明

在模板Resources和Outputs属性值中支持Fn::If内部函数,您可以使用ALIYUN::NoValue伪参数作为返回值来删除相应的属性。

函数声明

  • JSON

    {
      "Fn::If": [
        "condition_name",
        "value_if_true",
        "value_if_false"
      ]
    }
  • YAML

    • 完整函数的语法。

      Fn::If:
        - condition_name
        - value_if_true
        - value_if_false
    • 缩写形式。

      !If [condition_name, value_if_true, value_if_false]

参数信息

  • condition_name:Conditions中条件对应的条件名称。通过条件名称引用条件。

  • value_if_true:当指定的条件计算为true时,返回此值。

  • value_if_false:当指定的条件计算为false时,返回此值。

使用示例

根据输入的参数,确定是否创建数据盘。

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"
            }
          ]
        }
      }
    }
  }
}

支持的函数