دوال Bicep
توضح هذه المقالة جميع الوظائف التي يمكنك استخدامها في ملف Bicep. لتعريف الوظائف المخصصة، راجع الدالات المعرفة من قبل المستخدم. للحصول على وصف للأقسام في ملف Bicep، يُرجى الرجوع إلى فهم بنية وصيغة ملفات Bicep .
تعمل معظم الوظائف بالطريقة نفسها عند نشرها إلى مجموعة موارد أو اشتراك أو مجموعة إدارة أو مستأجر. لا يمكن استخدام بعض الوظائف في جميع النطاقات. لقد تم تدوينها في القوائم أدناه.
مساحات الأسماء للدول
يتم تضمين جميع دوال Bicep داخل مساحتين اسميتين - az
and sys
. بشكل عام، لا تحتاج إلى تحديد مساحة الاسم عند استخدام الدالة. أنت تحدد مساحة الاسم فقط عندما يكون اسم الدالة هو نفسه عنصر آخر قمت بتعريفه في ملف Bicep. على سبيل المثال، إذا قمت بإنشاء معلمة باسم range
، تحتاج إلى تمييز range
الدالة عن طريق إضافة مساحة الاسم 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)
تحتوي مساحة الاسم az
على دالات خاصة بنشر Azure. تحتوي مساحة الاسم sys
على دالات تستخدم لإنشاء قيم. تتضمن مساحة الاسم sys
أيضًا على تنسيقات للمعلمات وحلقات الموارد. يتم الإشارة إلى مساحات الأسماء في هذه المقالة.
أي دالة
تتوفر أي دالة في Bicep للمساعدة في حل المشاكل المتعلقة بتحذيرات نوع البيانات. هذه الدالة في مساحة الاسم sys
.
دوال الصفيف
الدوال التالية متاحة للعمل مع المصفوفات. توجد جميع هذه الدالات في مساحة الاسم sys
.
- صفيف
- concat
- تحتوي على
- فارغ
- indexOf
- أولاً
- flatten
- intersection
- last
- lastIndexOf
- الطول
- دقيقه
- max
- النطاق
- تخطي
- الوقت المستغرق
- union
دالات CIDR
تتوفر الدالات التالية للعمل مع CIDR. توجد جميع هذه الدالات في مساحة الاسم sys
.
دوال التاريخ
تتوفر الدوال التالية للعمل مع التواريخ. توجد جميع هذه الدالات في مساحة الاسم sys
.
دالات قيمة التوزيع
تتوفر الدالات التالية للحصول على القيم المتعلقة النشر. توجد جميع هذه الدالات في مساحة الاسم az
.
دوال الملف
تتوفر الدوال التالية لتحميل المحتوى من الملفات الخارجية في ملف Bicep. توجد جميع هذه الدالات في مساحة الاسم sys
.
دالات Lambda
تتوفر الدالات التالية للعمل مع تعبيرات lambda. توجد جميع هذه الدالات في مساحة الاسم sys
.
الدالات المنطقية
تتوفر الدالة التالية للعمل مع الشروط المنطقية. هذه الدالة في مساحة الاسم sys
.
دوال رقمية
تتوفر الدالات التالية للعمل مع الأعداد الصحيحة. توجد جميع هذه الدالات في مساحة الاسم sys
.
دوال الكائنات
تتوفر الدالات التالية للعمل مع الكائنات. توجد جميع هذه الدالات في مساحة الاسم sys
.
دالات ملف المعلمات
تتوفر الوظائف التالية لاستخدامها في ملفات معلمات Bicep. توجد جميع هذه الدالات في مساحة الاسم sys
.
دوال المصدر
تتوفر الدالات التالية للحصول على قيم الموارد. توجد جميع هذه الدالات في مساحة الاسم az
. يتم استدعاء دالات القائمة ووظيفة getSecret مباشرة على نوع المورد، لذلك ليس لديهم مؤهل مساحة الاسم.
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- providers (deprecated)
- reference
- ResourceId - يمكن استخدامها في أي نطاق، ولكن تتغير المعلمات الصالحة اعتمادًا على النطاق.
- subscriptionResourceId
- tenantResourceId
دوال النطاق
تتوفر الدالات التالية للحصول على قيم النطاق. توجد جميع هذه الدالات في مساحة الاسم az
.
- managementGroup
- ResourceGroup - يمكن استخدامها فقط في عمليات النشر لمجموعة الموارد.
- subscription - يمكن استخدامها فقط في عمليات النشر إلى مجموعة موارد أو اشتراك.
- tenant
دالات السلسلة
يوفر Bicep الدوال التالية للعمل مع السلاسل. توجد جميع هذه الدالات في مساحة الاسم sys
.
- قاعدة 64
- base64ToJson
- base64ToString
- concat
- تحتوي على
- dataUri
- dataUriToString
- فارغ
- endsWith
- أولاً
- format
- دليل
- indexOf
- join
- last
- lastIndexOf
- الطول
- newGuid
- padLeft
- replace
- تخطي
- split
- startsWith
- string
- substring
- الوقت المستغرق
- toLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
الخطوات التالية
- للحصول على وصف للأقسام في ملف Bicep، يُرجى الرجوع إلى فهم بنية وصيغة ملفات Bicep .
- لتكرار عدد معين من المرات عند إنشاء نوع من الموارد، يرجى الرجوع إلى التكرار الحلقي في Bicep.
- لمعرفة طريقة نشر ملف Bicep الذي قمت بإنشائه، راجع نشر الموارد باستخدام قوالب Bicep وAzure PowerShell.