Funkcje Bicep
W tym artykule opisano wszystkie funkcje, których można użyć w pliku Bicep. Aby zdefiniować funkcje niestandardowe, zobacz Funkcje zdefiniowane przez użytkownika. Opis sekcji w pliku Bicep można znaleźć w temacie Understand the structure and syntax of Bicep files (Opis struktury i składni plików Bicep).
Większość funkcji działa tak samo po wdrożeniu w grupie zasobów, subskrypcji, grupie zarządzania lub dzierżawie. Nie można używać kilku funkcji we wszystkich zakresach. Zostały one zanotowany na poniższych listach.
Przestrzenie nazw dla funkcji
Wszystkie funkcje Bicep znajdują się w dwóch przestrzeniach nazw — az
i sys
. Zazwyczaj nie trzeba określać przestrzeni nazw podczas korzystania z funkcji. Przestrzeń nazw określa się tylko wtedy, gdy nazwa funkcji jest taka sama jak inny element zdefiniowany w pliku Bicep. Jeśli na przykład utworzysz parametr o nazwie range
, musisz odróżnić range
funkcję przez dodanie sys
przestrzeni nazw.
// 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)
az
Przestrzeń nazw zawiera funkcje specyficzne dla wdrożenia platformy Azure. sys
Przestrzeń nazw zawiera funkcje używane do konstruowania wartości. sys
Przestrzeń nazw zawiera również dekoratory parametrów i pętli zasobów. Przestrzenie nazw zostały zanotowane w tym artykule.
Dowolna funkcja
Dowolna funkcja jest dostępna w aplikacji Bicep, aby pomóc w rozwiązywaniu problemów dotyczących ostrzeżeń dotyczących typu danych. Ta funkcja znajduje się w sys
przestrzeni nazw.
Funkcje tablicy
Poniższe funkcje są dostępne do pracy z tablicami. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
- tablica
- concat
- Contains
- empty
- indexOf
- pierwszy
- spłaszczyć
- skrzyżowanie
- ostatni
- lastIndexOf
- length
- Min
- Max
- range
- pominąć
- brać
- unia
Funkcje CIDR
Poniższe funkcje są dostępne do pracy z ciDR. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
Funkcje daty
Następujące funkcje są dostępne do pracy z datami. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
Funkcje wartości wdrożenia
Następujące funkcje są dostępne do uzyskiwania wartości związanych z wdrożeniem. Wszystkie te funkcje znajdują się w az
przestrzeni nazw.
Funkcje plików
Następujące funkcje są dostępne do ładowania zawartości z plików zewnętrznych do pliku Bicep. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
Funkcje lambda
Poniższe funkcje są dostępne do pracy z wyrażeniami lambda. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
Funkcja logiczna
Poniższa funkcja jest dostępna do pracy z warunkami logicznymi. Ta funkcja znajduje się w sys
przestrzeni nazw.
Funkcje liczbowe
Poniższe funkcje są dostępne do pracy z liczbami całkowitymi. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
Funkcje obiektów
Poniższe funkcje są dostępne do pracy z obiektami. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
Funkcje plików parametrów
Następujące funkcje są dostępne do użycia w plikach parametrów Bicep. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
Funkcje zasobów
Następujące funkcje są dostępne do pobierania wartości zasobów. Większość z tych funkcji należy do az
przestrzeni nazw. Funkcje listy i funkcja getSecret są wywoływane bezpośrednio w typie zasobu, więc nie mają kwalifikatora przestrzeni nazw.
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- lista*
- managementGroupResourceId
- pickZones
- dostawcy (przestarzałe)
- odniesienie
- resourceId — może być używany w dowolnym zakresie, ale prawidłowe parametry zmieniają się w zależności od zakresu.
- subscriptionResourceId
- tenantResourceId
Funkcje zakresu
Następujące funkcje są dostępne do uzyskiwania wartości zakresu. Wszystkie te funkcje znajdują się w az
przestrzeni nazw.
- managementGroup
- resourceGroup — może być używana tylko we wdrożeniach w grupie zasobów.
- subskrypcja — może być używana tylko we wdrożeniach w grupie zasobów lub subskrypcji.
- tenant
Funkcje ciągów
Bicep udostępnia następujące funkcje do pracy z ciągami. Wszystkie te funkcje znajdują się w sys
przestrzeni nazw.
- base64
- base64ToJson
- base64ToString
- concat
- Contains
- dataUri
- dataUriToString
- empty
- endsWith
- pierwszy
- format
- guid
- indexOf
- join
- ostatni
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- pominąć
- split
- startsWith
- string
- Podciąg
- brać
- toLower
- toUpper
- przycinać
- uniqueString
- Uri
- uriComponent
- uriComponentToString
Następne kroki
- Opis sekcji w pliku Bicep można znaleźć w temacie Understand the structure and syntax of Bicep files (Opis struktury i składni plików Bicep).
- Aby iterować określoną liczbę razy podczas tworzenia typu zasobu, zobacz Iteracyjne pętle w Bicep.
- Aby zobaczyć, jak wdrożyć utworzony plik Bicep, zobacz Deploy resources with Bicep and Azure PowerShell (Wdrażanie zasobów przy użyciu aplikacji Bicep i programu Azure PowerShell).