Funções do modelo do ARM
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.
- array
- concat
- contains
- createArray
- empty
- first
- indexOf
- intersection
- last
- lastIndexOf
- length
- max
- min
- range
- skip
- take
- union
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 lambda
O Gerenciador de Recursos fornece as seguintes funções para se trabalhar com expressões lambda.
Para arquivos Bicep, use as funções lambda.
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)
- referência
- references
- 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:
- base64
- base64ToJson
- base64ToString
- concat
- contains
- dataUri
- dataUriToString
- empty
- endsWith
- first
- format
- guid
- indexOf
- join
- json
- last
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- skip
- split
- startsWith
- cadeia de caracteres
- substring
- take
- toLower
- toUpper
- cortar
- uniqueString
- uri
- uriComponent
- uriComponentToString
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.