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

La propriété AllowedPattern 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 dans le cloud. Pour être averti avec un message d'erreur si la validation échoue, spécifiez la propriété ConstraintDescription dans le modèle. Vous pouvez personnaliser le message d'erreur dans la propriété ConstraintDescription pour rendre le message clair et explicite. Habituellement, les modèles CF incluent déjà les propriétés AllowedPattern et ConstraintDescription. Si ces propriétés ne sont pas présentes, vous pouvez les ajouter comme mentionné dans la procédure suivante :

Procédure

1. Dans le , accédez portail d'administration du cloudà Conception > Modèles dans le cloud.
2. Sélectionnez un modèle ou cliquez sur Nouveau pour créer un nouveau modèle dans le cloud.
   Si vous sélectionnez un modèle existant, renommez-le.
3. Dans la zone de texte Corps, effectuez les changements suivants dans un modèle ARM et CF.
   1. Dans un modèle ARM, effectuez les modifications suivantes :
      • Dans la section Métadonnées des paramètres, entrez SNC::Parameter::Metadata.
      • Ajoutez la clé AllowedPattern et saisissez une plage de valeurs valide.
      • Ajoutez la clé ConstraintDescription et saisissez 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, effectuez les modifications suivantes :
      • Ajoutez la clé AllowedPattern et saisissez une plage de valeurs valide.
      • Ajoutez la clé ConstraintDescription et saisissez 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.