Funzioni di 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 Informazioni sulla struttura e la 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
Le funzioni seguenti sono disponibili per l'uso con CIDR. Tutte queste funzioni si trovano nello spazio dei nomi sys
.
Funzioni di data
Per l'utilizzo delle date sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei nomi sys
.
Funzioni dei valori della distribuzione
Per ottenere valori correlati alla distribuzione sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei nomi az
.
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 nomi sys
.
Funzioni lambda
Per l'uso delle espressioni lambda sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei nomi sys
.
Funzioni logiche
La funzione seguente è disponibile per l'utilizzo di condizioni logiche. Questa funzione si trova nello spazio dei nomi sys
.
Funzioni numeriche
Le funzioni seguenti sono disponibili per l'utilizzo di numeri interi. Tutte queste funzioni si trovano nello spazio dei nomi sys
.
Funzioni di oggetti
Per l'utilizzo degli oggetti sono disponibili le funzioni seguenti. Tutte queste funzioni si trovano nello spazio dei nomi sys
.
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 nomi sys
.
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 funzioni list e la funzione getSecret vengono chiamate direttamente sul tipo di risorsa, quindi non hanno un qualificatore dello spazio dei nomi.
- 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 nomi az
.
- 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 una sottoscrizione.
- tenant
Funzioni di stringa
Bicep fornisce le funzioni seguenti per operare con le stringhe. Tutte queste funzioni si trovano nello spazio dei nomi 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
Passaggi successivi
- Per una descrizione delle sezioni in un file Bicep, vedere Informazioni sulla struttura e la sintassi dei file Bicep.
- Per eseguire l’iterazione di un numero specificato di volte durante la creazione di un tipo di risorsa, vedere Cicli iterativi in Bicep.
- Per informazioni su come distribuire il file Bicep creato, vedere Distribuire le risorse con Bicep e Azure PowerShell.