Valider une valeur de paramètre avec la propriété AllowedPattern

  • Rversion finale: Australia
  • Mis à jour 16 juin 2026
  • 1 minute de lecture

    • La AllowedPattern propriété d’un modèle Azure Resource Manager (ARM) et CloudFormation (CF) effectue la validation d’entrée avant d’envoyer une demande de mise en service.

    Avant de commencer

    Rôle requis : sn.cmp.cloud_service_designer

    Pourquoi et quand exécuter cette tâche

    Vous pouvez fournir des règles pour valider une valeur de paramètre avant d’envoyer la demande de mise en service au cloud. Pour recevoir un message d’erreur en cas d’échec de la validation, spécifiez la propriété dans le ConstraintDescription modèle. Vous pouvez personnaliser le message d’erreur dans la ConstraintDescription propriété pour le rendre clair et explicite. Habituellement, les modèles CF ont déjà les AllowedPattern propriétés and ConstraintDescription . Si ces propriétés ne sont pas présentes, vous pouvez les ajouter comme indiqué dans la procédure suivante :

    Procédure

    1. Dans le Portail d'administration du cloud, accédez à Conception > Modèles dans le cloud.
    2. Sélectionnez un modèle ou cliquez sur Nouveau pour créer un modèle dans le cloud.
      Si vous sélectionnez un modèle existant, renommez-le.
    3. Dans la zone de texte Corps , apportez les modifications suivantes à un modèle ARM et CF.
      1. Dans un modèle ARM, apportez ces modifications :
        • Dans la section des métadonnées des paramètres, saisissez SNC::Parameter::Metadata.
        • Ajoutez la AllowedPattern clé et entrez une plage de valeurs valide.
        • Ajoutez la ConstraintDescription clé et entrez un message d’erreur.
        "parameters": {
         "newStorageAccountName": {
             "type": "string",
              "metadata": {
                  "description": "Unique DNS Name for the Storage Account where the Virtual Machine's disks will be placed.",
                   "SNC::Parameter::Metadata": {
                       "allowedPattern": "[0-9a-z]{1,11}",
                        "ConstraintDescription": "must be an alphanumeric "
                                              
                           }}} 
       
   
      2. Dans un modèle CF, apportez les modifications suivantes :
        • Ajoutez la AllowedPattern clé et entrez une plage de valeurs valide.
        • Ajoutez la ConstraintDescription clé et entrez un message d’erreur.
        "Parameters" : {
                "SSHLocation" : {
                "Description" : "The IP address range that can be used to SSH to the EC2 instances",
                "Type": "String",
                "MinLength": "9",
                "MaxLength": "18",
                "Default": "0.0.0.0/0",
                 "AllowedPattern": "(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})/(\\d{1,2})",
                 "ConstraintDescription": "must be a valid IP CIDR range of the form x.x.x.x/x."

    } 
  }
    4. Cliquez sur Envoyer.