Validieren Sie einen Parameterwert mit der Eigenschaft AllowedPattern

  • Freigeben Version: Yokohama
  • Aktualisiert 25. Juni 2026
  • 1 Minute Lesedauer
  • Die AllowedPatternDie Eigenschaft in einer Azure Resource Manager- (ARM)- und CloudFormation-(CF)-Vorlage führt eine Eingabevalidierung durch, bevor eine Bereitstellungsanforderung gesendet wird.

    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 Sie die Bereitstellungsanforderung an die Cloud senden. Um mit einer Fehlermeldung benachrichtigt zu werden, wenn die Validierung fehlschlägt, geben Sie an ConstraintDescriptionEigenschaft in der Vorlage. Sie können die Fehlermeldung in anpassen ConstraintDescriptionEigenschaft, um die Nachricht klar und explizit zu machen. Normalerweise haben die CF-Vorlagen bereits AllowedPatternUnd ConstraintDescriptionEigenschaften. Wenn diese Eigenschaften nicht vorhanden sind, können Sie sie wie im folgenden Verfahren erwähnt hinzufügen:

    Prozedur

    1. In Portal für Cloud-Admin., Navigieren Sie zu Design > Cloud-Vorlagenan.
    2. Wählen Sie eine Vorlage aus, oder klicken Sie auf Neu Zum Erstellen einer neuen Cloud-Vorlage.
      Wenn Sie eine vorhandene Vorlage auswählen, benennen Sie die Vorlage um.
    3. In Textkörper Textfeld: Nehmen Sie die folgenden Änderungen in einer ARM- und einer CF-Vorlage vor.
      1. Nehmen Sie in einer ARM-Vorlage die folgenden Änderungen vor:
        • Geben Sie im Abschnitt „Parameter-Metadaten“ ein SNC::Parameter::Metadata.
        • Fügen Sie hinzu AllowedPatternGeben Sie einen gültigen Wertbereich ein.
        • Fügen Sie hinzu ConstraintDescriptionGeben Sie eine Fehlermeldung ein, und geben Sie sie 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 hinzu AllowedPatternGeben Sie einen gültigen Wertbereich ein.
        • Fügen Sie hinzu ConstraintDescriptionGeben Sie eine Fehlermeldung ein, und geben Sie sie 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.