Compartilhar 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 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.

Namespaces para funções

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

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

Funções de matriz

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

Funções CIDR (entre domínios sem classificação)

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

Funções de data

As funções a seguir 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 obtenção de valores relacionados à implantação. Todas essas funções estão no az namespace:

Funções de arquivo

As funções a seguir 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 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 funções a seguir estão disponíveis para trabalhar com inteiros. Todas essas funções estão no sys namespace:

Funções de objeto

As funções a seguir 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 funções a seguir estão disponíveis para serem usadas em arquivos de parâmetros do Bicep. Todas essas funções estão no sys namespace:

Funções de recurso

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

Funções de escopo

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 de caracteres

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

Próximas etapas