Funções do Bicep

  • Artigo

Este artigo descreve todas as funções que você pode usar em um arquivo Bicep. Para obter uma descrição das seções de um arquivo Bicep, consulte Noções básicas de estrutura e sintaxe dos arquivos Bicep.

A maioria das funções funcionam da mesma forma quando são 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

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 data

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

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 namespace az.

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 namespace sys.

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 namespace sys.

Funções lógicas

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

Funções numéricas

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

Funções de objeto

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

Funções de arquivo de parâmetros

A função getSecret está disponível no Bicep para obter um valor seguro de um KeyVault. Essa função é definida no namespace az.

A função readEnvironmentVariable está disponível no Bicep para ler valores de variáveis de ambiente. Essa função é definida no namespace sys.

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. A lista de funções e a função getsecret são chamadas diretamente no tipo de recurso, portanto, não têm um qualificador de namespace.

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 namespace az.

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 namespace sys.

Próximas etapas