Partilhar via

Visão geral das funções do bíceps

  • Artigo

Este artigo descreve todas as funções que você pode usar em um arquivo Bicep. Para definir funções personalizadas, consulte Funções definidas pelo usuário. Para obter uma descrição das seções em um arquivo Bicep, consulte Estrutura e sintaxe do arquivo Bicep.

A maioria das funções funciona da mesma forma quando implantada em um grupo de recursos, assinatura, grupo de gerenciamento ou locatário. Algumas funções não podem ser usadas em todos os escopos. Eles são anotados nas listas abaixo.

Namespaces para funções

Todas as funções do Bicep estão contidas em dois namespaces - az e sys. Normalmente, você não precisa especificar o namespace quando usa a função. Você especifica o namespace somente quando o nome da função é o mesmo que outro item definido no arquivo Bicep. Por exemplo, se você criar um parâmetro chamado range, precisará diferenciar a range função adicionando o sys namespace.

// 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 namespace contém funções específicas para uma implantação do Azure. O sys namespace contém funções que são usadas para construir valores. O sys namespace também inclui decoradores para parâmetros e loops de recursos. Os namespaces são observados neste artigo.

Qualquer função

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

Funções de matriz

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

Funções CIDR (Classless inter-domain)

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

Funções de data

As seguintes funções estão disponíveis para trabalhar com datas. Todas essas funções estão no sys namespace:

Funções de valor de implantação

As funções a seguir estão disponíveis para obter valores relacionados à implantação. Todas essas funções estão no az namespace:

Funções de arquivo

As seguintes funções estão disponíveis para carregar o conteúdo de arquivos externos em seu arquivo Bicep. Todas essas funções estão no sys namespace:

Funções do Lambda

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

Função lógica

A função a seguir está disponível para trabalhar com condições lógicas. Esta função está no sys namespace:

Funções numéricas

As seguintes funções estão disponíveis para trabalhar com números inteiros. Todas essas funções estão no sys namespace:

Funções de objeto

As seguintes funções estão disponíveis para trabalhar com objetos. Todas essas funções estão no sys namespace:

Funções de arquivo de parâmetros

As seguintes funções estão disponíveis para serem usadas em arquivos de parâmetros Bicep. Todas essas funções estão no sys namespace:

Funções de recursos

As funções a seguir estão disponíveis para obter valores de recursos. A maioria dessas funções está no az namespace. As list funções e getSecret não têm qualificadores de namespace, pois são nomeadas diretamente no tipo de recurso:

Funções de âmbito

As funções a seguir estão disponíveis para obter valores de escopo. Todas essas funções estão no az namespace:

Funções de cadeia

O Bicep fornece as seguintes funções para trabalhar com cadeias de caracteres. Todas essas funções estão no sys namespace:

Próximos passos