Parameterwert mit der AllowedPattern-Eigenschaft validieren

Die Eigenschaft AllowedPattern in einer Vorlage von Azure Resource Manager (ARM) oder CloudFormation (CF) führt vor dem Senden einer Bereitstellungsanforderung eine Eingabevalidierung durch.

Vorbereitungen

Erforderliche Rolle: sn_cmp.cloud_service_designer

Warum und wann dieser Vorgang ausgeführt wird

Sie können Regeln bereitstellen, um einen Parameterwert zu validieren, bevor die Bereitstellungsanforderung an die Cloud gesendet wird. Um bei einer fehlgeschlagenen Validierung mit einer Fehlermeldung benachrichtigt zu werden, geben Sie die Eigenschaft ConstraintDescription in der Vorlage an. Sie können die Fehlermeldung in der Eigenschaft ConstraintDescription anpassen, um die Nachricht klar und eindeutig zu formulieren. Normalerweise verfügen die CF-Vorlagen bereits über die Eigenschaften AllowedPattern und ConstraintDescription. Wenn diese Eigenschaften nicht vorhanden sind, können Sie sie wie im folgenden Verfahren erwähnt hinzufügen:

Prozedur

1. Navigieren Sie in Portal für Cloud-Admin.zu Design > Cloud-Vorlagen.
2. Wählen Sie eine Vorlage aus, oder klicken Sie auf Neu, um eine neue Cloud-Vorlage zu erstellen.
   Wenn Sie eine vorhandene Vorlage auswählen, benennen Sie die Vorlage um.
3. Nehmen Sie in einer ARM- oder einer CF-Vorlage im Textfeld Text die folgenden Änderungen vor.
   1. Nehmen Sie in einer ARM-Vorlage die folgenden Änderungen vor:
      • Geben Sie im Abschnitt „parameters“ unter „metadata“ SNC::Parameter::Metadata ein.
      • Fügen Sie den Schlüssel AllowedPattern hinzu, und geben Sie einen gültigen Wertebereich ein.
      • Fügen Sie den Schlüssel ConstraintDescription hinzu, und geben Sie eine Fehlermeldung ein.

      "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. Nehmen Sie in einer CF-Vorlage die folgenden Änderungen vor:
      • Fügen Sie den Schlüssel AllowedPattern hinzu, und geben Sie einen gültigen Wertebereich ein.
      • Fügen Sie den Schlüssel ConstraintDescription hinzu, und geben Sie eine Fehlermeldung ein.

      "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. Klicken Sie auf Absenden.