Funções do modelo do ARM

Artigo
08/03/2023

Este artigo descreve todas as funções que você pode usar em um modelo do Azure Resource Manager (modelo do ARM). Para obter informações sobre como usar funções no seu modelo, consulte sintaxe do modelo.

Para criar suas próprias funções, consulte Funções definidas pelo usuário.

A maioria das funções funcionam da mesma forma, independentemente de serem implantadas em um grupo de recursos, uma assinatura, um grupo de gerenciamento ou um locatário. Algumas funções não podem ser usadas em todos os escopos. Elas são indicadas nas listas abaixo.

Dica

Recomendamos o Bicep porque ele oferece as mesmas funcionalidades que os modelos do ARM e a sintaxe é mais fácil de usar. Para saber mais, consulte funções Bicep e operadores Bicep.

Qualquer função

A função any está disponível no Bicep para ajudar a resolver problemas relacionados a avisos de tipo de dados.

Funções de matriz

O Resource Manager fornece diversas funções para trabalhar com matrizes.

Para arquivos Bicep, use as funções de matriz.

Funções CIDR

As funções a seguir estão disponíveis para trabalhar com CIDR. Todas essas funções estão no namespace sys.

Funções de comparação

O Resource Manager fornece várias funções para fazer comparações em seus modelos.

Para arquivos Bicep, use o operador lógico de coalesce. Para comparações, use os operadores de comparação.

Funções de data

O Resource Manager fornece as seguintes funções para trabalhar com datas.

Para arquivos Bicep, use as funções de data.

Funções de valor de implantação

O Gerenciador de Recursos fornece as seguintes funções para obter os valores de seções do modelo e os valores relacionados à implantação:

Para arquivos Bicep, use as funções de implantação.

Funções lógicas

O Gerenciador de Recursos fornece as seguintes funções para trabalhar com condições lógicas:

Para arquivos Bicep, use a função lógica de bool. Para outros valores lógicos, use operadores lógicos.

Funções numéricas

O Gerenciador de Recursos fornece as seguintes funções para trabalhar com números inteiros:

Para arquivos Bicep que usam int, min e max usam funções numéricas. Para outros valores numéricos, use operadores numéricos.

Funções de objeto

O Resource Manager fornece diversas funções para trabalhar com objetos.

Para arquivos Bicep, use as funções do objeto.

Funções de recurso

O Gerenciador de Recursos fornece as seguintes funções para obter valores de recurso:

extensionResourceId
listAccountSas
listKeys
listSecrets
list*
pickZones
provedores (preterido)
reference
referências
resourceId – pode ser usada em qualquer escopo, mas os parâmetros válidos mudam com base no escopo.
subscriptionResourceId
tenantResourceId

Para arquivos Bicep, use as funções de recurso.

Funções de escopo

O Resource Manager fornece as seguintes funções para obter valores do escopo da implantação:

managementGroup – só pode ser usado em implantações para um grupo de gerenciamento.
resourceGroup – só pode ser usada em implantações em um grupo de recursos.
subscription – só pode ser usada em implantações em um grupo de recursos ou uma assinatura.
locatário – pode ser usado para implantações em qualquer escopo.

Para arquivos Bicep, use as funções de escopo.

Funções de cadeia de caracteres

O Gerenciador de Recursos fornece as seguintes funções para trabalhar com cadeias de caracteres:

Para arquivos Bicep, use as funções de cadeia de caracteres.

Próximas etapas

Para obter uma descrição das seções de um modelo do ARM, confira Entender a estrutura e a sintaxe dos modelos do ARM.
Para mesclar vários modelos, confira Usando modelos vinculados e aninhados ao implantar recursos do Azure.
Para iterar um número especificado de vezes ao criar um tipo de recurso, confira Iteração de recursos em modelos do ARM.
Para ver como implantar o modelo que você criou, confira Implantar recursos com modelos do ARM e o Azure PowerShell.