Panoramica delle funzioni Bicep
Questo articolo descrive tutte le funzioni che è possibile usare in un file Bicep. Per definire funzioni personalizzate, vedere Funzioni definite dall'utente. Per una descrizione delle sezioni in un file Bicep, vedere Struttura e sintassi dei file Bicep.
La maggior parte delle funzioni funziona allo stesso modo quando viene distribuita in un gruppo di risorse, una sottoscrizione, un gruppo di gestione o un tenant. Alcune funzioni non possono essere usate in tutti gli ambiti. Sono indicati negli elenchi seguenti.
Spazi dei nomi per le funzioni
Tutte le funzioni Bicep sono contenute all'interno di due spazi dei nomi : az
e sys
. In genere, non è necessario specificare lo spazio dei nomi quando si usa la funzione. Specificare lo spazio dei nomi solo quando il nome della funzione è uguale a un altro elemento definito nel file Bicep. Ad esempio, se si crea un parametro denominato range
, è necessario distinguere la funzione range
aggiungendo lo spazio dei nomi 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)
Lo spazio dei nomi az
contiene funzioni specifiche di una distribuzione di Azure. Lo spazio dei nomi sys
contiene funzioni utilizzate per costruire valori. Lo spazio dei nomi sys
include anche elementi decorator per parametri e cicli di risorse. Gli spazi dei nomi sono indicati in questo articolo.
Qualsiasi funzione
La funzione qualsiasi è disponibile in Bicep per risolvere i problemi relativi agli avvisi relativi al tipo di dati. Questa funzione si trova nello spazio dei nomi sys
.
Funzioni matrice
Per l'uso delle matrici sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei nomi sys
.
- array
- concat
- contains
- empty
- indexOf
- first
- flatten
- intersection
- last
- lastIndexOf
- length
- min
- max
- range
- skip
- take
- union
Funzioni CIDR (Classless Inter-Domain)
Le funzioni seguenti sono disponibili per l'uso con CIDR. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
Funzioni di data
Per l'utilizzo delle date sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
Funzioni dei valori della distribuzione
Per ottenere valori correlati alla distribuzione sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei az
nomi :
Funzioni di archiviazione
Le funzioni seguenti sono disponibili per caricare il contenuto da file esterni nel file Bicep. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
Funzioni lambda
Per l'uso delle espressioni lambda sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
Funzione logica
La funzione seguente è disponibile per l'utilizzo di condizioni logiche. Questa funzione si trova nello spazio dei sys
nomi :
Funzioni numeriche
Le funzioni seguenti sono disponibili per l'utilizzo di numeri interi. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
Funzioni di oggetti
Per l'utilizzo degli oggetti sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
Funzioni dei file dei parametri
Le funzioni seguenti sono disponibili per essere usate nei file di parametri Bicep. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
Funzioni delle risorse
Per ottenere i valori delle risorse sono disponibili le funzioni seguenti. La maggior parte di queste funzioni si trova nello spazio dei nomi az
. Le list
funzioni e getSecret
non hanno qualificatori dello spazio dei nomi perché sono denominati direttamente nel tipo di risorsa:
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- provider (deprecato)
- reference
- resourceId : può essere usato in qualsiasi ambito, ma i parametri validi cambiano a seconda dell'ambito.
- subscriptionResourceId
- tenantResourceId
Funzioni di ambito
Per ottenere i valori di ambito sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei az
nomi :
- managementGroup
- resourceGroup : può essere usato solo nelle distribuzioni in un gruppo di risorse.
- sottoscrizione : può essere usata solo nelle distribuzioni in un gruppo di risorse o in una sottoscrizione.
- tenant
Funzioni di stringa
Bicep fornisce le funzioni seguenti per operare con le stringhe. Tutte queste funzioni si trovano nello spazio dei sys
nomi :
- 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
Passaggi successivi
- Per eseguire l'iterazione di un numero specifico di volte in cui si crea un tipo di risorsa, vedere Cicli iterativi in Bicep.
- Per informazioni su come distribuire il file Bicep creato, vedere Distribuire file Bicep con l'interfaccia della riga di comando di Azure e Azure PowerShell.