Funciones de Bicep

En este artículo se describen todas las funciones que puede usar en un archivo de Bicep. Puede encontrar una descripción de las secciones de un archivo de Bicep en Nociones sobre la estructura y la sintaxis de los archivos de Bicep.

La mayoría de las funciones operan de la misma forma cuando se implementan en un grupo de recursos, en una suscripción, en un grupo de administración o en un inquilino. Hay algunas funciones que no pueden utilizarse en todos los ámbitos. Se indican en las listas siguientes.

Espacios de nombres para funciones

Todas las funciones de Bicep se encuentran dentro de dos espacios de nombres: az y sys. Normalmente, no es necesario especificar el espacio de nombres cuando se usa la función. Especifique el espacio de nombres solo cuando el nombre de la función sea el mismo que otro elemento que haya definido en el archivo Bicep. Por ejemplo, si crea un parámetro denominado range, debe diferenciar la función range mediante la incorporación del espacio de nombres 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)

El espacio de nombres az contiene funciones específicas de una implementación de Azure. El espacio de nombres sys contiene funciones que se usan para construir valores. El espacio de nombres sys también incluye elementos decoradores para parámetros y bucles de recursos. Los espacios de nombres se anotan en este artículo.

Cualquier función

La función any está disponible en Bicep para ayudar a resolver problemas relacionados con las advertencias de tipos de datos. Esta función está en el espacio de nombres sys.

Funciones de matriz

Las siguientes funciones están disponibles para trabajar con matrices. Todas estas funciones están en el espacio de nombres sys.

Funciones CIDR

Las siguientes funciones están disponibles para trabajar con CIDR. Todas estas funciones están en el espacio de nombres sys.

Funciones de fecha

Las siguientes funciones están disponibles para trabajar con fechas. Todas estas funciones están en el espacio de nombres sys.

Funciones con valores de implementación

Las siguientes funciones están disponibles para obtener valores relacionados con la implementación. Todas estas funciones están en el espacio de nombres az.

Funciones de archivo

Las siguientes funciones están disponibles para cargar el contenido de archivos externos en el archivo Bicep. Todas estas funciones están en el espacio de nombres sys.

Funciones Lambda

Las siguientes funciones están disponibles para trabajar con expresiones lambda. Todas estas funciones están en el espacio de nombres sys.

Funciones lógicas

La siguiente función está disponible para trabajar con condiciones lógicas. Esta función está en el espacio de nombres sys.

Funciones numéricas

Las siguientes funciones están disponibles para trabajar con enteros. Todas estas funciones están en el espacio de nombres sys.

Funciones de objeto

Las siguientes funciones están disponibles para trabajar con objetos. Todas estas funciones están en el espacio de nombres sys.

Funciones de archivo de parámetros

La función getSecret está disponible en Bicep para obtener un valor seguro de KeyVault. Esta función está en el espacio de nombres az.

La función readEnvironmentVariable está disponible en Bicep para leer los valores de las variables de entorno. Esta función está en el espacio de nombres sys.

Funciones de recursos

Las siguientes funciones están disponibles para obtener valores de recursos. La mayoría de estas funciones están en el espacio de nombres az. Las funciones list y la función getSecret se llaman directamente en el tipo de recurso, por lo que no tienen un calificador de espacio de nombres.

Funciones de Scope

Las siguientes funciones están disponibles para obtener valores de ámbito. Todas estas funciones están en el espacio de nombres az.

  • managementGroup
  • resourceGroup: solo puede utilizarse cuando la implementación se realiza en un grupo de recursos.
  • subscription: solo puede utilizarse cuando la implementación se realiza en un grupo de recursos o una suscripción.
  • tenant

Funciones de cadena

Bicep ofrece las siguientes funciones para trabajar con cadenas. Todas estas funciones están en el espacio de nombres sys.

Pasos siguientes