Funkce Bicep
Tento článek popisuje všechny funkce, které můžete použít v souboru Bicep. Popis oddílů v souboru Bicep najdete v tématu Vysvětlení struktury a syntaxe souborů Bicep.
Většina funkcí funguje stejně při nasazení do skupiny prostředků, předplatného, skupiny pro správu nebo tenanta. Několik funkcí není možné použít ve všech oborech. Jsou uvedené v následujících seznamech.
Obory názvů pro funkce
Všechny funkce Bicep jsou obsaženy ve dvou oborech názvů – az
a sys
. Při použití funkce obvykle nemusíte zadávat obor názvů. Obor názvů zadáte jenom v případech, kdy je název funkce stejný jako jiná položka, kterou jste definovali v souboru Bicep. Pokud například vytvoříte parametr s názvem range
, musíte funkci odlišit range
přidáním sys
oboru názvů.
// 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)
Obor az
názvů obsahuje funkce, které jsou specifické pro nasazení Azure. Obor sys
názvů obsahuje funkce, které se používají k vytváření hodnot. Obor sys
názvů zahrnuje také dekorátory parametrů a smyček prostředků. Obory názvů jsou uvedené v tomto článku.
Libovolná funkce
Funkce any je k dispozici v nástroji Bicep, která pomáhá řešit problémy související s upozorněními datových typů. Tato funkce je v sys
oboru názvů.
Funkce pro práci s poli
Pro práci s poli jsou k dispozici následující funkce. Všechny tyto funkce jsou v sys
oboru názvů.
- Pole
- Concat
- Obsahuje
- empty
- Indexof
- První
- Zploštit
- Průsečíku
- Poslední
- Lastindexof
- length
- min
- Max
- Rozsah
- Přeskočit
- užívat
- Unie
Funkce CIDR
Pro práci s CIDR jsou k dispozici následující funkce. Všechny tyto funkce jsou v sys
oboru názvů.
Datové funkce
Pro práci s kalendářními daty jsou k dispozici následující funkce. Všechny tyto funkce jsou v sys
oboru názvů.
Funkce hodnot nasazení
Pro získání hodnot souvisejících s nasazením jsou k dispozici následující funkce. Všechny tyto funkce jsou v az
oboru názvů.
Funkce souborů
Pro načtení obsahu z externích souborů do souboru Bicep jsou k dispozici následující funkce. Všechny tyto funkce jsou v sys
oboru názvů.
Funkce Lambda
Pro práci s výrazy lambda jsou k dispozici následující funkce. Všechny tyto funkce jsou v sys
oboru názvů.
Logické funkce
Pro práci s logickými podmínkami je k dispozici následující funkce. Tato funkce je v sys
oboru názvů.
Numerické funkce
Pro práci s celými čísly jsou k dispozici následující funkce. Všechny tyto funkce jsou v sys
oboru názvů.
Objektové funkce
Pro práci s objekty jsou k dispozici následující funkce. Všechny tyto funkce jsou v sys
oboru názvů.
Funkce souboru parametrů
Funkce getSecret je k dispozici v nástroji Bicep, aby získala zabezpečenou hodnotu z KeyVaultu. Tato funkce je v az
oboru názvů.
Funkce readEnvironmentVariable je v nástroji Bicep k dispozici pro čtení hodnot proměnných prostředí. Tato funkce je v sys
oboru názvů.
Funkce prostředků
Pro získání hodnot prostředků jsou k dispozici následující funkce. Většina těchto funkcí je v az
oboru názvů. Funkce seznamu a funkce getSecret se volají přímo u typu prostředku, takže nemají kvalifikátor oboru názvů.
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- Seznamu*
- pickZones
- poskytovatelé (zastaralé)
- Odkaz
- resourceId – lze použít v libovolném oboru, ale platné parametry se mění v závislosti na rozsahu.
- subscriptionResourceId
- tenantResourceId
Funkce oboru
Pro získání hodnot oboru jsou k dispozici následující funkce. Všechny tyto funkce jsou v az
oboru názvů.
- managementGroup
- resourceGroup – dá se použít jenom v nasazeních do skupiny prostředků.
- předplatné – dá se použít jenom v nasazeních do skupiny prostředků nebo předplatného.
- tenant
Funkce řetězců
Bicep poskytuje následující funkce pro práci s řetězci. Všechny tyto funkce jsou v sys
oboru názvů.
- base64
- base64ToJson
- base64ToString
- Concat
- Obsahuje
- identifikátor dataUri
- dataUriToString
- empty
- Endswith
- První
- Formát
- Identifikátor guid
- Indexof
- Připojit
- Poslední
- Lastindexof
- length
- newGuid
- padLeft
- Nahradit
- Přeskočit
- Rozdělit
- Startswith
- řetězec
- Podřetězec
- užívat
- Tolower
- Toupper
- Trim
- jedinečný řetězec
- Uri
- uriComponent
- uriComponentToString
Další kroky
- Popis oddílů v souboru Bicep najdete v tématu Vysvětlení struktury a syntaxe souborů Bicep.
- Informace o iteraci zadaného počtu při vytváření typu prostředku najdete v tématu Iterativní smyčky v nástroji Bicep.
- Postup nasazení vytvořeného souboru Bicep najdete v tématu Nasazení prostředků pomocí bicepu a Azure PowerShell.