Tipos de dados em modelos ARM

Este artigo descreve os tipos de dados suportados nos modelos do Azure Resource Manager (modelos ARM).

Tipos suportados

Em um modelo ARM, você pode usar estes tipos de dados:

  • matriz
  • Bool
  • Int
  • objecto
  • secureObject
  • securestring
  • cadeia (de caracteres)

Matrizes

Os arrays começam com um colchete esquerdo ([) e terminam com um colchete direito (]). Uma matriz pode ser declarada em uma única linha ou em várias linhas. Cada elemento é separado por uma vírgula.

"parameters": {
  "exampleArray": {
    "type": "array",
    "defaultValue": [
      1,
      2,
      3
    ]
  }
},

"outputs": {
  "arrayOutput": {
    "type": "array",
    "value": "[variables('exampleArray')]"
  },
  "firstExampleArrayElement": {
    "type": "int",
    "value": "[parameters('exampleArray')[0]]"
  }
}

Os elementos de uma matriz podem ser do mesmo tipo ou tipos diferentes.

"variables": {
  "mixedArray": [
    "[resourceGroup().name]",
    1,
    true,
    "example string"
  ]
}

"outputs": {
  "arrayOutput": {
    "type": "array",
    "value": "[variables('mixedArray')]"
  },
  "firstMixedArrayElement": {
    "type": "string",
    "value": "[variables('mixedArray')[0]]"
  }
}

Booleanos

Ao especificar valores booleanos, use true ou false. Não coloque o valor entre aspas.

"parameters": {
  "exampleBool": {
    "type": "bool",
    "defaultValue": true
  }
},

Números inteiros

Ao especificar valores inteiros, não use aspas.

"parameters": {
  "exampleInt": {
    "type": "int",
    "defaultValue": 1
  }
}

Para inteiros passados como parâmetros embutidos, o intervalo de valores pode ser limitado pelo SDK ou pela ferramenta de linha de comando que você usa para implantação. Por exemplo, ao usar o PowerShell para implantar um modelo, os tipos inteiros podem variar de -2147483648 a 2147483647. Para evitar essa limitação, especifique valores inteiros grandes em um ficheiro de parâmetros. Os tipos de recursos aplicam os seus próprios limites para propriedades inteiras.

Objetos

Os objetos começam com uma chave esquerda ({) e terminam com uma chave direita (}). Cada propriedade em um objeto consiste em key e value. Os key e value estão entre aspas duplas e separados por dois pontos (:). Cada propriedade é separada por uma vírgula.

"parameters": {
  "exampleObject": {
    "type": "object",
    "defaultValue": {
      "name": "test name",
      "id": "123-abc",
      "isCurrent": true,
      "tier": 1
    }
  }
}

Você pode obter uma propriedade de um objeto com notação de ponto.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "exampleObject": {
            "type": "object",
            "defaultValue": {
                "name": "test name",
                "id": "123-abc",
                "isCurrent": true,
                "tier": 1
            }
        }
    },
    "resources": [
    ],
    "outputs": {
        "nameFromObject": {
            "type": "string",
            "value": "[parameters('exampleObject').name]"
        }
    }
}

Em JSON, um objeto é uma coleção não ordenada de zero ou mais pares chave/valor. A ordenação pode ser diferente dependendo das implementações. Por exemplo, a função Bicep items() classifica os objetos na ordem alfabética. Em outros lugares, a ordenação original pode ser preservada. Devido a este não determinismo, evite fazer suposições sobre a ordenação de chaves de objeto ao escrever código que interaja com parâmetros e saídas de implantação.

Cordas

As cadeias de caracteres são marcadas com aspas duplas.

"parameters": {
  "exampleString": {
    "type": "string",
    "defaultValue": "test value"
  }
},

Segurança de cadeias de caracteres e objetos

Secure string usa o mesmo formato que string, e secure object usa o mesmo formato que object. Quando defines um parâmetro como uma cadeia segura ou um objeto seguro, a implantação não guarda o valor do parâmetro no histórico de implantação nem o regista. A ocultação não é garantida para variantes transformadas ou derivadas desse valor. Para as orientações completas de redação de dados, consulte Parâmetros Seguros. Se definir um valor seguro para uma propriedade que não espera um valor seguro, o valor não fica protegido. Por exemplo, se definir uma cadeia de caracteres segura para uma etiqueta, esse valor será armazenado como texto simples. Utilize cadeias de caracteres seguras para palavras-passe e segredos.

O exemplo a seguir mostra dois parâmetros seguros.

"parameters": {
  "password": {
    "type": "securestring"
  },
  "configValues": {
    "type": "secureObject"
  }
}

Observação

Não use cadeias de caracteres ou objetos seguros como valores de saída. Se você incluir um valor seguro como um valor de saída, o valor não será exibido no histórico de implantação e não poderá ser recuperado de outro modelo. Em vez disso, salve o valor seguro em um cofre de chaves e passe como um parâmetro do cofre de chaves.

Próximos passos

Para saber mais sobre a sintaxe do modelo, consulte Compreender a estrutura e a sintaxe dos modelos ARM.