Fungsi Bicep
Artikel ini menjelaskan semua fungsi yang dapat digunakan dalam file Bicep. Untuk mengetahui deskripsi bagian-bagian dalam file Bicep, lihat Memahami struktur dan sintaks file Bicep.
Sebagian besar fungsi berfungsi sama saat disebarkan ke grup sumber daya, langganan, grup manajemen, atau penyewa. Beberapa fungsi tidak dapat digunakan di semua cakupan. Mereka tercantum dalam daftar di bawah ini.
Namespace layanan untuk fungsi
Semua fungsi Bicep terkandung di dalam dua namespace layanan - az dan sys. Biasanya, Anda tidak perlu menentukan namespace layanan ketika menggunakan fungsi tersebut. Anda menentukan namespace layanan hanya ketika nama fungsi sama dengan item lain yang telah Anda tentukan dalam file Bicep. Misalnya, jika Anda membuat parameter bernama range, Anda perlu membedakan fungsi range dengan menambahkan namespace layanan 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)
Namespace layanan az berisi fungsi khusus untuk penyebaran Azure. Namespace layanan sys berisi fungsi yang digunakan untuk membangun nilai. Namespace layanan sys juga mencakup dekorator untuk perulangan parameter dan sumber daya. Namespace layanan dicatat dalam artikel ini.
Fungsi any
Fungsi any tersedia di Bicep untuk membantu menyelesaikan masalah seputar peringatan tipe data. Fungsi ini berada di namespace layanan sys.
Fungsi array
Fungsi berikut ini tersedia untuk bekerja dengan array. Semua fungsi ini berada di namespace layanan sys.
- array
- concat
- berisi
- kosong
- indexOf
- pertama
- flatten
- intersection
- last
- lastIndexOf
- length
- mnt
- max
- range
- skip
- ambil
- union
Fungsi CIDR
Fungsi berikut tersedia untuk bekerja dengan CIDR. Semua fungsi ini berada di namespace layanan sys.
Fungsi tanggal
Fungsi berikut tersedia untuk bekerja dengan tanggal. Semua fungsi ini berada di namespace layanan sys.
Fungsi nilai penyebaran
Fungsi berikut tersedia untuk mendapatkan nilai yang terkait dengan penyebaran. Semua fungsi ini berada di namespace layanan az.
Fungsi file
Fungsi berikut tersedia untuk memuat konten dari file eksternal ke file Bisep Anda. Semua fungsi ini berada di namespace layanan sys.
Fungsi lambda
Fungsi berikut tersedia untuk bekerja dengan ekspresi lambda. Semua fungsi ini berada di namespace layanan sys.
Fungsi logika
Fungsi berikut tersedia untuk bekerja dengan kondisi logis. Fungsi ini berada di namespace layanan sys.
Fungsi numerik
Fungsi berikut tersedia untuk bekerja dengan bilangan bulat. Semua fungsi ini berada di namespace layanan sys.
Fungsi objek
Fungsi berikut ini tersedia untuk bekerja dengan objek. Semua fungsi ini berada di namespace layanan sys.
Fungsi file parameter
Fungsi getSecret tersedia di Bicep untuk mendapatkan nilai aman dari KeyVault. Fungsi ini berada di namespace layanan az.
Fungsi readEnvironmentVariable tersedia di Bicep untuk membaca nilai variabel lingkungan. Fungsi ini berada di namespace layanan sys.
Fungsi sumber daya
Fungsi berikut tersedia untuk mendapatkan nilai sumber daya. Sebagian besar fungsi ini berada di namespace layanan az. Fungsi daftar dan fungsi getSecret dipanggil secara langsung pada jenis sumber daya, sehingga mereka tidak memiliki pengkualifikasi namespace layanan.
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- pickZones
- penyedia (tidak digunakan lagi)
- reference
- resourceId - dapat digunakan pada cakupan apa pun, tetapi parameter yang valid berubah tergantung cakupannya.
- subscriptionResourceId
- tenantResourceId
Fungsi cakupan
Fungsi berikut ini tersedia untuk mendapatkan nilai cakupan. Semua fungsi ini berada di namespace layanan az.
- managementGroup
- resourceGroup - hanya dapat digunakan dalam penyebaran ke grup sumber daya.
- subscription - hanya dapat digunakan dalam penyebaran ke grup sumber daya atau langganan.
- penyewa
Fungsi untai (karakter)
Bicep menyediakan fungsi berikut untuk bekerja dengan untai (karakter). Semua fungsi ini berada di namespace layanan sys.
- base64
- base64ToJson
- base64ToString
- concat
- contains
- dataUri
- dataUriToString
- empty
- endsWith
- first
- format
- guid
- indexOf
- gabung
- last
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- skip
- split
- startsWith
- string
- substring
- take
- toLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
Langkah berikutnya
- Untuk mengetahui deskripsi bagian-bagian dalam file Bicep, lihat Memahami struktur dan sintaks file Bicep.
- Untuk melakukan pengulangan dalam jumlah tertentu saat membuat jenis sumber daya, lihat Perulangan sumber daya di Bicep berulang.
- Untuk melihat cara menyebarkan file Bicep yang telah dibuat, lihat Menyebarkan sumber daya dengan Bicep dan Azure PowerShell.