دالات قالب ARM
توضح هذه المقالة جميع الدوال التي يمكنك استخدامها في قالبAzure Resource Manager (قالب ARM). للحصول على معلومات حول استخدام الدوال في القالب الخاص بك، راجع template syntax.
لإنشاء الدوال الخاصة بك، راجع User-defined functions.
تعمل معظم الوظائف بالطريقة نفسها عند نشرها إلى مجموعة موارد أو اشتراك أو مجموعة إدارة أو مستأجر. لا يمكن استخدام بعض الوظائف في جميع النطاقات. لقد تم تدوينها في القوائم أدناه.
تلميح
نوصي باستخدام Bicep لأنها تقدم نفس الإمكانات التي توفرها نماذج ARM ولأن البنية أسهل في الاستخدام. لمعرفة المزيد، راجع دوال Bicep وعوامل تشغيل Bicep.
أي دالة
تتوفر أي دالة في Bicep للمساعدة في حل المشاكل المتعلقة بتحذيرات نوع البيانات.
دوال الصفيف
توفر Resource Manager دوال عديدة للعمل مع الصفائف.
- صفيف
- concat
- تحتوي على
- createArray
- فارغ
- أولاً
- indexOf
- intersection
- last
- lastIndexOf
- الطول
- max
- دقيقه
- النطاق
- تخطي
- الوقت المستغرق
- union
بالنسبة لملفات Bicep، استخدم دوال array.
دالات CIDR
تتوفر الدالات التالية للعمل مع CIDR. توجد جميع هذه الدالات في مساحة الاسم sys
.
دوال المقارنة
توفر Resource Manager العديد من الدوال لإجراء مقارنات في القوالب.
بالنسبة لملفات Bicep، استخدم عامل التشغيل المنطقي الدمج. للمقارنات، استخدم عوامل التشغيل المقارنة.
دوال التاريخ
توفر Resource Manager الدوال التالية للعمل مع التواريخ.
بالنسبة لملفات Bicep، استخدم دوال date.
دالات قيمة التوزيع
توفر Resource Manager الدوال التالية للحصول على القيم من أقسام القالب والقيم المتعلقة بالنشر:
بالنسبة لملفات Bicep، استخدم دوال deployment.
دالات Lambda
يوفر Resource Manager الوظائف التالية للعمل مع تعبيرات lambda.
الدالات المنطقية
توفر Resource Manager الدوال التالية للعمل مع الشروط المنطقية:
بالنسبة لملفات Bicep، استخدم الوظيفة المنطقية bool. للقيم المنطقية الأخرى، استخدم عوامل التشغيل logical.
دوال رقمية
توفر Resource Manager الدوال التالية للعمل مع الأعداد الصحيحة:
لملفات Bicep التي تستخدم int
, min
, max
دوال numeric. للقيم الرقمية الأخرى، استخدم عوامل التشغيل numeric.
دوال الكائنات
توفر Resource Manager العديد من الدوال للعمل مع الكائنات.
بالنسبة لملفات Bicep، استخدم دوال object.
دوال المصدر
توفر Resource Manager الدوال التالية للحصول على قيم الموارد:
- extensionResourceId
- listAccountSas
- listKeys
- listSecrets
- list*
- pickZones
- providers (deprecated)
- reference
- مراجع
- ResourceId - يمكن استخدامها في أي نطاق، ولكن تتغير المعلمات الصالحة اعتمادًا على النطاق.
- subscriptionResourceId
- tenantResourceId
بالنسبة لملفات Bicep، استخدم دوال resource.
دوال النطاق
يوفر Resource Manager الدوال التالية للحصول على قيم الموارد:
- managementGroup - يمكن استخدامها فقط في عمليات التوزيع إلى مجموعة إدارة.
- ResourceGroup - يمكن استخدامها فقط في عمليات النشر لمجموعة الموارد.
- subscription - يمكن استخدامها فقط في عمليات النشر إلى مجموعة موارد أو اشتراك.
- المستأجر - يمكن استخدامه في عمليات التوزيع في أي نطاق.
بالنسبة لملفات Bicep، استخدم دوال scope.
دالات السلسلة
توفر Resource Manager الدوال التالية للعمل مع السلاسل:
- قاعدة 64
- base64ToJson
- base64ToString
- concat
- تحتوي على
- dataUri
- dataUriToString
- فارغ
- endsWith
- أولاً
- format
- دليل
- indexOf
- join
- json
- last
- lastIndexOf
- الطول
- newGuid
- padLeft
- replace
- تخطي
- split
- startsWith
- string
- substring
- الوقت المستغرق
- toLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
بالنسبة لملفات Bicep، استخدم دوال string.
الخطوات التالية
- للحصول على وصف للأقسام الموجودة في قالب ARM، انظرفهم بنية قوالب ARM وهيكلها.
- لدمج عدة قوالب، راجع استخدام القوالب المرتبطة والمتداخلة عند توزيع موارد Azure .
- لتكرار عدد معين من المرات عند إنشاء نوع من الموارد، راجع تكرار الموارد الواردة في قوالب ARM .
- لمعرفة طريقة نشر النموذج الذي قمت بإنشائه، راجع نشر الموارد باستخدام قوالب ARM وAzure PowerShell .