Gambaran umum fungsi Bicep
Artikel ini menjelaskan semua fungsi yang dapat Anda gunakan dalam file Bicep. Untuk menentukan fungsi kustom, lihat Fungsi yang ditentukan pengguna. Untuk deskripsi bagian dalam file Bicep, lihat 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
- mengandung
- kosong
- indexOf
- first
- flatten
- persimpangan
- last
- lastIndexOf
- length
- min
- max
- rentang
- skip
- take
- union
Fungsi antar-domain tanpa kelas (CIDR)
Fungsi berikut tersedia untuk bekerja dengan CIDR. Semua fungsi ini berada di sys namespace layanan:
Fungsi tanggal
Fungsi berikut tersedia untuk bekerja dengan tanggal. Semua fungsi ini berada di sys namespace layanan:
Fungsi nilai penyebaran
Fungsi berikut tersedia untuk mendapatkan nilai yang terkait dengan penyebaran. Semua fungsi ini berada di az namespace layanan:
Fungsi file
Fungsi berikut tersedia untuk memuat konten dari file eksternal ke file Bisep Anda. Semua fungsi ini berada di sys namespace layanan:
Fungsi lambda
Fungsi berikut tersedia untuk bekerja dengan ekspresi lambda. Semua fungsi ini berada di sys namespace layanan:
Fungsi logika
Fungsi berikut tersedia untuk bekerja dengan kondisi logis. Fungsi ini ada di sys namespace layanan:
Fungsi numerik
Fungsi berikut tersedia untuk bekerja dengan bilangan bulat. Semua fungsi ini berada di sys namespace layanan:
Fungsi objek
Fungsi berikut ini tersedia untuk bekerja dengan objek. Semua fungsi ini berada di sys namespace layanan:
Fungsi file parameter
Fungsi berikut tersedia untuk digunakan dalam file parameter Bicep. Semua fungsi ini berada di sys namespace layanan:
Fungsi sumber daya
Fungsi berikut tersedia untuk mendapatkan nilai sumber daya. Sebagian besar fungsi ini berada di namespace layanan az. Fungsi list dan getSecret tidak memiliki kualifikasi namespace karena dinamai langsung dalam jenis sumber daya:
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- penyedia (tidak digunakan lagi)
- referensi
- resourceId - Ini dapat digunakan pada cakupan apa pun, tetapi parameter yang valid berubah tergantung pada cakupannya.
- subscriptionResourceId
- tenantResourceId
Fungsi cakupan
Fungsi berikut ini tersedia untuk mendapatkan nilai cakupan. Semua fungsi ini berada di az namespace layanan:
- managementGroup
- resourceGroup - Ini hanya dapat digunakan dalam penyebaran ke grup sumber daya.
- langganan - Ini hanya dapat digunakan dalam penyebaran ke grup sumber daya atau langganan.
- penyewa
Fungsi string
Bicep menyediakan fungsi berikut untuk bekerja dengan untai (karakter). Semua fungsi ini berada di sys namespace layanan:
- base64
- base64ToJson
- base64KeUntai
- concat
- mengandung
- dataUri
- dataUriToString
- kosong
- endsWith
- first
- format
- Guid
- indexOf
- join
- last
- lastIndexOf
- length
- newGuid
- padLeft
- mengganti
- skip
- belah
- startsWith
- tali
- substring
- take
- ToLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
Langkah berikutnya
- Untuk mengulangi beberapa kali tertentu saat membuat jenis sumber daya, lihat Perulangan berulang di Bicep.
- Untuk mempelajari cara menyebarkan file Bicep yang telah Anda buat, lihat Menyebarkan file Bicep dengan Azure CLI dan Azure PowerShell.