Fonctions des modèles ARM

Cet article décrit toutes les fonctions que vous pouvez utiliser dans un modèle Azure Resource Manager (modèle ARM). Pour plus d’informations sur l’utilisation des fonctions dans votre modèle, voir Syntaxe du modèle.

Pour créer vos propres fonctions, consultez Fonctions définies par l’utilisateur.

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.

Conseil

Nous recommandons Bicep parce qu’il offre les mêmes fonctionnalités que les modèles ARM et que la syntaxe est plus facile d’utilisation. Pour en savoir plus, consultez Fonctions Bicep et Opérateurs Bicep.

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.

Fonctions Tableau

Resource Manager fournit les fonctions ci-après pour travailler avec des tableaux.

• array
• concat
• contains
• createArray
• empty
• first
• indexOf
• intersection
• last
• lastIndexOf
• length
• max
• min
• range
• skip
• take
• union

Pour les fichiers Bicep, utilisez les fonctions de tableau.

Fonctions CIDR

Les fonctions suivantes permettent de travailler avec le CIDR. Toutes ces fonctions se trouvent dans l’espace de noms sys.

• parseCidr
• cidrSubnet
• cidrHost

Fonctions de comparaison

Resource Manager fournit plusieurs fonctions pour effectuer des comparaisons dans vos modèles.

• coalesce
• equals
• greater
• greaterOrEquals
• less
• lessOrEquals

Pour les fichiers Bicep, utilisez l’opérateur logique de fusion. Pour les comparaisons, utilisez les opérateurs de comparaison.

Fonctions de date

Resource Manager fournit les fonctions ci-après pour utiliser les dates.

• dateTimeAdd
• dateTimeFromEpoch
• dateTimeToEpoch
• utcNow

Pour les fichiers Bicep, utilisez les fonctions de date.

Fonctions de valeur de déploiement

Resource Manager offre les fonctions ci-après pour l’obtention de valeurs à partir des sections du modèle et de valeurs associées au déploiement :

• deployment
• environment
• parameters
• variables

Pour les fichiers Bicep, utilisez les fonctions de déploiement.

Fonctions lambda

Resource Manager fournit les fonctions suivantes pour vous permettre de travailler avec des expressions lambda.

• filter
• groupBy
• map
• mapValues
• reduce
• sort
• toObject

Pour les fichiers Bicep, utilisez les fonctions lambda.

Fonctions logiques

Resource Manager fournit les fonctions suivantes pour vous permettre de travailler avec des conditions logiques :

• and
• bool
• false
• if
• not
• or
• true

Pour les fichiers Bicep, utilisez la fonction logique bool. Pour les autres valeurs logiques, utilisez les opérateurs logiques.

Fonctions Numériques

Resource Manager fournit les expressions ci-après pour travailler avec des entiers :

• add
• copyIndex
• div
• float
• int
• min
• max
• mod
• mul
• sub

Pour les fichiers Bicep qui utilisent int, min et max, utilisez les fonctions numériques. Pour les autres valeurs numériques, consultez les opérateurs numériques.

Fonctions d’objet

Resource Manager fournit les fonctions ci-après pour travailler avec des objets.

• contains
• createObject
• empty
• intersection
• items
• json
• length
• objectKeys
• null
• shallowMerge
• union

Pour les fichiers Bicep, utilisez les fonctions d’objet.

Fonctions de ressource

Resource Manager offre les fonctions ci-après pour obtenir des valeurs de ressource :

• extensionResourceId
• listAccountSas
• listKeys
• listSecrets
• list*
• pickZones
• providers (déconseillé)
• reference
• références
• resourceId - peut être utilisée dans n’importe quelle étendue, mais les paramètres valides changent en fonction de l’étendue.
• subscriptionResourceId
• tenantResourceId

Pour les fichiers Bicep, utilisez les fonctions de ressource.

Fonctions de limitation

Resource Manager offre les fonctions ci-après pour obtenir des valeurs d’étendue de déploiement :

• managementGroup - ne peut être utilisé que dans les déploiements vers un groupe de gestion.
• 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.
• tenant - peut être utilisé pour les déploiements à n’importe quelle étendue.

Pour les fichiers Bicep, utilisez les fonctions de limitation.

Fonctions de chaînes

Resource Manager fournit les fonctions ci-après pour travailler avec des chaînes de caractères :

• base64
• base64ToJson
• base64ToString
• concat
• contains
• dataUri
• dataUriToString
• empty
• endsWith
• first
• format
• guid
• indexOf
• join
• json
• last
• lastIndexOf
• length
• newGuid
• padLeft
• replace
• skip
• split
• startsWith
• string
• substring
• take
• toLower
• toUpper
• trim
• uniqueString
• uri
• uriComponent
• uriComponentToString

Pour les fichiers Bicep, utilisez les fonctions de chaîne.

Étapes suivantes

• Pour obtenir une description des sections d’un modèle ARM, consultez Comprendre la structure et la syntaxe des modèles ARM.
• Pour fusionner plusieurs modèles, consultez Utilisation de modèles liés et imbriqués lors du déploiement de ressources Azure.
• Pour itérer un nombre spécifié lors de la création d’un type de ressource, consultez Itération de ressource dans les modèles ARM.
• Pour découvrir comment déployer le modèle que vous avez créé, consultez Déployer des ressources avec des modèles ARM et Azure PowerShell.