Vue d’ensemble des fonctions Bicep
Cet article décrit toutes les fonctions que vous pouvez utiliser dans un fichier Bicep. Pour définir des fonctions personnalisées, consultez les fonctions définies par l’utilisateur. Pour obtenir une description des sections d’un fichier Bicep, consultez la structure et la syntaxe des fichiers Bicep.
La plupart des fonctions opèrent de la même façon quand elles sont déployées sur un groupe de ressources, un abonnement, un groupe d’administration ou un locataire. Certaines fonctions ne peuvent pas être utilisées dans toutes les étendues. Elles sont indiquées dans les listes ci-dessous.
Espaces de noms pour les fonctions
Toutes les fonctions Bicep sont contenues dans deux espaces de noms : az
et sys
. En règle générale, vous ne devez pas spécifier l’espace de noms lorsque vous utilisez la fonction. Vous ne spécifiez l’espace de noms que lorsque le nom de la fonction est le même qu’un autre élément que vous avez défini dans le fichier Bicep. Par exemple, si vous créez un paramètre nommé range
, vous devez différencier la fonction range
en ajoutant l'espace de noms 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)
L'espace de noms az
contient des fonctions spécifiques à un déploiement Azure. L'espace de noms sys
contient des fonctions utilisées pour construire des valeurs. L'espace de noms sys
comprend également des éléments décoratifs pour les paramètres et les boucles de ressources. Les espaces de noms sont notés dans cet article.
Toutes les fonctions
La fonction any est disponible dans bicep pour aider à résoudre les problèmes concernant les avertissements de type de données. Cette fonction est définie dans l'espace de noms sys
.
Fonctions Tableau
Les fonctions suivantes sont disponibles pour l’utilisation de tableaux. Toutes ces fonctions se trouvent dans l’espace de noms sys
.
- array
- concat
- contains
- empty
- indexOf
- first
- flatten
- intersection
- last
- lastIndexOf
- length
- min
- max
- range
- skip
- take
- union
Fonctions CIDR (Classless inter-domain)
Les fonctions suivantes permettent de travailler avec le CIDR. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
Fonctions de date
Les fonctions suivantes sont disponibles pour l’utilisation de dates. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
Fonctions de valeur de déploiement
Les fonctions suivantes sont disponibles pour l’obtention de valeurs associées au déploiement. Toutes ces fonctions se trouvent dans l’espace az
de noms :
Fonctions de fichier
Les fonctions suivantes sont disponibles pour le chargement du contenu à partir de fichiers externes dans votre fichier Bicep. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
Fonctions lambda
Les fonctions suivantes sont disponibles pour l’utilisation d’expressions lambda. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
Fonction logique
La fonction suivante est disponible pour l’utilisation de conditions logiques. Cette fonction se trouve dans l’espace sys
de noms :
Fonctions Numériques
Les fonctions suivantes sont disponibles pour l’utilisation d’entiers. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
Fonctions d’objet
Les fonctions suivantes sont disponibles pour l’utilisation d’objets. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
Fonctions du fichier de paramètres
Les fonctions suivantes sont disponibles pour être utilisées dans les fichiers de paramètres Bicep. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
Fonctions de ressource
Les fonctions suivantes sont disponibles pour l’obtention de valeurs de ressource. La plupart de ces fonctions se trouvent dans l’espace de noms az
. Les list
fonctions et getSecret
les fonctions n’ont pas de qualificateurs d’espace de noms, car ils sont nommés directement dans le type de ressource :
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- providers (déconseillé)
- référence
- resourceId : cela peut être utilisé à n’importe quelle étendue, mais les paramètres valides changent en fonction de l’étendue.
- subscriptionResourceId
- tenantResourceId
Fonctions de limitation
Les fonctions suivantes sont disponibles pour l’obtention de valeurs d’étendue. Toutes ces fonctions se trouvent dans l’espace az
de noms :
- managementGroup
- resourceGroup : cela ne peut être utilisé que dans les déploiements dans un groupe de ressources.
- abonnement : cela ne peut être utilisé que dans les déploiements dans un groupe de ressources ou un abonnement.
- client
Fonctions de chaînes
Bicep fournit les fonctions suivantes pour travailler avec des chaînes. Toutes ces fonctions se trouvent dans l’espace sys
de noms :
- base64
- base64ToJson
- base64ToString
- concat
- contains
- dataUri
- dataUriToString
- empty
- endsWith
- first
- format
- guid
- indexOf
- join
- last
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- skip
- split
- startsWith
- string
- substring
- take
- toLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
Étapes suivantes
- Pour itérer un nombre spécifique de fois lors de la création d’un type de ressource, consultez les boucles itératives dans Bicep.
- Pour savoir comment déployer le fichier Bicep que vous avez créé, consultez Déployer des fichiers Bicep avec Azure CLI et Azure PowerShell.