Funções bicep

  • Artigo

Este artigo descreve todas as funções que pode utilizar num ficheiro Bicep. Para obter uma descrição das secções num ficheiro Bicep, veja Compreender a estrutura e a sintaxe dos ficheiros bicep.

A maioria das funções funciona da mesma forma quando implementadas num grupo de recursos, subscrição, grupo de gestão ou inquilino. Algumas funções não podem ser utilizadas em todos os âmbitos. São anotados nas listas abaixo.

Espaços de nomes para funções

Todas as funções do Bicep estão contidas em dois espaços de nomes - az e sys. Normalmente, não precisa de especificar o espaço de nomes quando utiliza a função. Só especifica o espaço de nomes quando o nome da função for o mesmo que outro item que definiu no ficheiro Bicep. Por exemplo, se criar um parâmetro com o nome range, terá de diferenciar a range função ao adicionar o sys espaço de nomes.

// Parameter contains the same name as a function
param range int

// Must use sys namespace to call the function.
// The second use of range refers to the parameter.
output result array = sys.range(1, range)

O az espaço de nomes contém funções específicas de uma implementação do Azure. O sys espaço de nomes contém funções que são utilizadas para construir valores. O sys espaço de nomes também inclui decoradores para parâmetros e ciclos de recursos. Os espaços de nomes são indicados neste artigo.

Qualquer função

Qualquer função está disponível no Bicep para ajudar a resolver problemas relacionados com avisos de tipo de dados. Esta função está no sys espaço de nomes.

Funções de matriz

As seguintes funções estão disponíveis para trabalhar com matrizes. Todas estas funções estão no sys espaço de nomes.

Funções CIDR

As seguintes funções estão disponíveis para trabalhar com CIDR. Todas estas funções estão no sys espaço de nomes.

Funções de data

As seguintes funções estão disponíveis para trabalhar com datas. Todas estas funções estão no sys espaço de nomes.

Funções de valor de implementação

As seguintes funções estão disponíveis para obter valores relacionados com a implementação. Todas estas funções estão no az espaço de nomes.

Funções de ficheiro

As seguintes funções estão disponíveis para carregar o conteúdo de ficheiros externos para o ficheiro Bicep. Todas estas funções estão no sys espaço de nomes.

Funções Lambda

As seguintes funções estão disponíveis para trabalhar com expressões lambda. Todas estas funções estão no sys espaço de nomes.

Funções lógicas

A função seguinte está disponível para trabalhar com condições lógicas. Esta função está no sys espaço de nomes.

Funções numéricas

As seguintes funções estão disponíveis para trabalhar com números inteiros. Todas estas funções estão no sys espaço de nomes.

Funções de objeto

As seguintes funções estão disponíveis para trabalhar com objetos. Todas estas funções estão no sys espaço de nomes.

Funções de ficheiro de parâmetros

A função getSecret está disponível no Bicep para obter o valor seguro de um KeyVault. Esta função está no az espaço de nomes.

A função readEnvironmentVariable está disponível no Bicep para ler valores de variáveis de ambiente. Esta função está no sys espaço de nomes.

Funções de recursos

As seguintes funções estão disponíveis para obter valores de recursos. A maioria destas funções encontra-se no az espaço de nomes. As funções de lista e a função getSecret são chamadas diretamente no tipo de recurso, pelo que não têm um qualificador de espaço de nomes.

Funções de âmbito

As seguintes funções estão disponíveis para obter valores de âmbito. Todas estas funções estão no az espaço de nomes.

Funções de cadeia

O Bicep fornece as seguintes funções para trabalhar com cadeias de carateres. Todas estas funções estão no sys espaço de nomes.

Passos seguintes