Funkce Bicep
Tento článek popisuje všechny funkce, které můžete použít v souboru Bicep. Pokud chcete definovat vlastní funkce, přečtěte si téma Uživatelem definované funkce. 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í se nedá 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 pouze 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 specifické pro nasazení Azure. Obor sys
názvů obsahuje funkce, které se používají k vytvoření hodnot. Obor sys
názvů obsahuje také dekorátory pro parametry a smyčky prostředků. Obory názvů jsou uvedeny v tomto článku.
Libovolná funkce
V Bicep je k dispozici libovolná funkce , která vám pomůže vyřešit problémy s upozorněními datového typu. 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
- range
- Přeskočit
- vzít
- 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 souborů parametrů
V souborech parametrů Bicep jsou k dispozici následující funkce. Všechny tyto funkce jsou 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*
- managementGroupResourceId
- pickZones
- poskytovatelé (zastaralé)
- Odkaz
- resourceId – lze použít v libovolném oboru, ale platné parametry se mění v závislosti na oboru.
- 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 – lze použít pouze 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.
- Nájemce
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í
- format
- Identifikátor guid
- Indexof
- join
- Poslední
- Lastindexof
- length
- newGuid
- padLeft
- replace
- Přeskočit
- split
- Startswith
- string
- Podřetězec
- vzít
- Tolower
- Toupper
- Trim
- uniqueString
- Uri
- uriComponent
- uriComponentToString
Další kroky
- Popis oddílů v souboru Bicep najdete v tématu Vysvětlení struktury a syntaxe souborů Bicep.
- Pokud chcete iterovat zadaný počet opakování při vytváření typu prostředku, přečtěte si téma Iterativní smyčky v Bicep.
- Pokud chcete zjistit, jak nasadit soubor Bicep, který jste vytvořili, přečtěte si téma Nasazení prostředků pomocí Bicep a Azure PowerShellu.