Validar um valor de parâmetro com a propriedade AllowedPattern

  • Versão de lançamento: Xanadu
  • Atualizado 9 de jan. de 2026
  • 1 min. de leitura
  • A propriedade AllowedPattern em um modelo do Azure Resource Manager (ARM) e do CloudFormation (CF) executa a validação de entrada antes de enviar uma solicitação de provisionamento.

    Antes de Iniciar

    Função necessária: sn.cmp.cloud_service_designer

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode fornecer regras para validar um valor de parâmetro antes de enviar a solicitação de provisionamento para a nuvem. Para ser notificado com uma mensagem de erro se a validação falhar, especifique a propriedade ConstraintDescription no modelo. Você pode personalizar a mensagem de erro na propriedade ConstraintDescription para tornar a mensagem clara e explícita. Normalmente, os modelos de CF já têm as propriedades AllowedPattern e ConstraintDescription. Se essas propriedades não estiverem presentes, você poderá adicioná-las conforme mencionado no seguinte procedimento:

    Procedimento

    1. Em Portal de Administração de Nuvem, navegue até Design > Modelos para nuvem.
    2. Selecione um modelo ou clique em Novo para criar um novo modelo de nuvem.
      Se você selecionar um modelo existente, renomeie o modelo.
    3. Na caixa de texto Corpo, faça as seguintes mudanças em um ARM e um modelo de CF.
      1. Em um modelo ARM, faça estas mudanças:
        • Na seção de metadados de parâmetros, insira SNC::Parameter::Metadata.
        • Adicione a chave AllowedPattern e insira um intervalo de valores válido.
        • Adicione a chave ConstraintDescription e insira uma mensagem de erro.
        "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. Em um modelo de CF, faça estas mudanças:
        • Adicione a chave AllowedPattern e insira um intervalo de valores válido.
        • Adicione a chave ConstraintDescription e insira uma mensagem de erro.
        "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. Clique em Enviar.