Tous les produits
Search
Centre de documentation

Resource Orchestration Service:Fn::If

Dernière mise à jour :Aug 10, 2026

La fonction Fn::If renvoie l’une des deux valeurs spécifiées selon qu’une condition donnée est vraie ou fausse.

Remarque

Les sections Resources et Outputs des modèles prennent en charge la fonction Fn::If. Utilisez le pseudo-paramètre ALIYUN::NoValue comme valeur de retour pour supprimer une propriété.

Déclaration

  • JSON

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

    • Syntaxe du nom complet de la fonction :

      Fn::If:
        - condition_name
        - value_if_true
        - value_if_false
    • Syntaxe de la forme courte :

      !If [condition_name, value_if_true, value_if_false]

Paramètres

  • condition_name : nom d’une condition définie dans la section Conditions.

  • value_if_true : valeur renvoyée si la condition est vraie.

  • value_if_false : valeur renvoyée si la condition est fausse.

Exemples

L’exemple suivant détermine s’il faut créer des disques de données en fonction des paramètres d’entrée :

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

Fonctions prises en charge