استكشاف الأخطاء وإصلاحها باستخدام Azure Blueprints

هام

في 11 يوليو 2026، سيتم إهمال المخططات (إصدار أولي). قم بترحيل تعريفات المخططات والتعيينات الموجودة إلى مواصفات القالبومكدسات التوزيع. سيتم تحويل البيانات الاصطناعية للمخطط إلى قوالب ARM JSON أو ملفات Bicep المستخدمة لتعريف مكدسات التوزيع. لمعرفة كيفية تأليف أداة كمورد ARM، راجع:

قد تواجه أخطاء عند إنشاء المخططات أو تعيينها أو إزالتها. هذه المقالة توضح الأخطاء المختلفة التي قد تحدث وكيفية حلها.

العثور على تفاصيل الخطأ

العديد من الأخطاء ستكون نتيجة تعيين مخطط إلى نطاق. عند فشل التعيين، يوفر المخطط تفاصيل حول التوزيع الفاشل. تشير هذه المعلومات إلى المشكلة بحيث يمكن إصلاحها ونجاح التوزيع التالي.

  1. حدد ⁧⁩All services⁩ في الجزء الأيسر. ابحث عن ⁧⁩Blueprints⁧⁩ وحددها.

  2. حدد Assigned blueprints من الصفحة على اليسار، واستخدم مربع البحث لتصفية تعيينات المخطط للعثور على التعيين الفاشل. كما يمكنك فرز جدول التعيينات حسب عمود Provisioning State لمشاهدة كافة التعيينات الفاشلة مجمعة معًا.

  3. حدد المخطط بحالة Failed، أو انقر بزر الماوس الأيمن، وحدد View assignment details.

  4. يوجد تحذير بشعار أحمر لفشل التعيين في أعلى صفحة تعيين المخطط. حدد أي مكان على الشعار للحصول على مزيد من التفاصيل.

من الشائع أن يكون الخطأ ناتجًا عن أداة، وليس المخطط ككل. إذا أنشأت أداة Key Vault، ويمنع نهج Azure إنشاء Key Vault، فسيفشل التعيين بأكمله.

أخطاء عامة

السيناريو: انتهاك النهج

مشكلة

فشل توزيع القالب بسبب انتهاك النهج.

السبب

قد يتعارض النهج مع التوزيع للأسباب التالية:

  • المورد الذي يتم إنشاؤه مقيد بواسطة النهج (عادة SKU أو قيود الموقع)
  • التوزيع عبارة عن تعيين الحقول التي تم تكوينها بواسطة النهج (شائعة مع العلامات)

الدقة

قم بتغيير المخطط بحيث لا يتعارض مع النهج في تفاصيل الخطأ. إذا لم يكن هذا التغيير ممكنًا، فإن الخيار البديل هو تغيير نطاق تعيين النهج بحيث لم يعد المخطط متعارضًا مع النهج.

السيناريو: معلمة المخطط عبارة عن دالة

مشكلة

تتم معالجة معلمات المخطط التي هي دوال قبل تمريرها إلى البيانات الاصطناعية.

السبب

يؤدي تمرير معلمة مخطط تستخدم دالة، مثل [resourceGroup().tags.myTag]، إلى بيانات اصطناعية إلى النتيجة المعالجة للدالة التي يتم تعيينها على الأداة بدلا من الدالة الديناميكية.

الدقة

لتمرير دالة كمعلمة، تجاوز السلسلة بأكملها بحيث [ تبدو معلمة المخطط مثل [[resourceGroup().tags.myTag]. حرف الإلغاء يتسبب في تعامل Blueprints مع القيمة كسلسلة عند معالجة المخطط. ثم تضع خدمة Blueprints الدالة على البيانات الاصطناعية مما يتيح لها أن تكون ديناميكية كما هو متوقع. لمزيد من المعلومات، راجع بناء الجملة والتعبيرات في قوالب Azure Resource Manager.

حذف الأخطاء

السيناريو: مهلة حذف التعيين

مشكلة

حذف تعيين المخطط لا يكتمل.

السبب

تعيين المخطط قد يصبح عالقًا في حالة غير طرفية عند حذفه. هذه الحالة تحدث عندما لا تزال الموارد التي تم إنشاؤها بواسطة تعيين المخطط معلقة للحذف أو لا ترجع رمز حالة إلى Azure Blueprints.

الدقة

يتم وضع علامة Failed تلقائيًا على تعيينات المخطط في حالة غير طرفية بعد مهلة مدتها ست ساعات. بمجرد تعديل المهلة لحالة تعيين المخطط، يمكن إعادة محاولة الحذف.

الخطوات التالية

إذا لم تتعرف على مشكلتك أو لم تتمكن من حلها، فتفضل بزيارة إحدى القنوات التالية للحصول على مزيد من الدعم:

  • احصل على إجابات من خبراء Azure من خلال منتديات Azure.
  • تواصل مع @AzureSupport - حساب Microsoft Azure الرسمي لتحسين تجربة العملاء من خلال ربط مجتمع Azure بالموارد المناسبة: الإجابات والدعم والخبراء.
  • إذا كنت بحاجة إلى مزيد من المساعدة، يمكنك تقديم حدث دعم Azure. انتقل إلى ⁧⁧⁩⁩موقع دعم Azure⁧⁧⁩⁩، وحدد ⁧⁧⁩⁩Get Support⁧⁧⁩⁩.