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 Comprendre 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
Les fonctions suivantes permettent de travailler avec le CIDR. Toutes ces fonctions se trouvent dans l’espace de noms sys
.
Fonctions de date
Les fonctions suivantes sont disponibles pour l’utilisation de dates. Toutes ces fonctions se trouvent dans l’espace de noms sys
.
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 de noms az
.
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 de noms sys
.
Fonctions lambda
Les fonctions suivantes sont disponibles pour l’utilisation d’expressions lambda. Toutes ces fonctions se trouvent dans l’espace de noms sys
.
Fonction logique
La fonction suivante est disponible pour l’utilisation de conditions logiques. Cette fonction est définie dans l'espace de noms sys
.
Fonctions Numériques
Les fonctions suivantes sont disponibles pour l’utilisation d’entiers. Toutes ces fonctions se trouvent dans l’espace de noms sys
.
Fonctions d’objet
Les fonctions suivantes sont disponibles pour l’utilisation d’objets. Toutes ces fonctions se trouvent dans l’espace de noms sys
.
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 de noms sys
.
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 fonctions de liste et la fonction getSecret sont appelées directement sur le type de ressource, de sorte qu’elles n’ont pas de qualificateur d’espace de noms.
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- providers (déconseillé)
- reference
- resourceId - peut être utilisée dans 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 de noms az
.
- managementGroup
- resourceGroup - peut être utilisée uniquement dans les déploiements sur un groupe de ressources.
- subscription - peut être utilisée uniquement dans les déploiements sur 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 de noms sys
.
- 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 obtenir une description des sections d’un fichier Bicep, consultez Comprendre la structure et la syntaxe des fichiers Bicep.
- Pour itérer un nombre spécifié de fois lors de la création d’un type de ressource, consultez Boucles itératives dans Bicep.
- Pour découvrir comment déployer le fichier Bicep que vous avez créé, consultez Déployer des ressources avec Bicep et Azure PowerShell.