استكشاف أخطاء توزيع Azure الشائعة وإصلاحها

توضح هذه المقالة كيفية استكشاف أخطاء توزيع Azure الشائعة وإصلاحها، وتوفر معلومات حول الحلول. يمكن توزيع موارد Azure باستخدام ملفات Bicep أو قوالب Azure Resource Manager (قوالب ARM). إذا لم تتمكن من العثور على رمز الخطأ لخطأ التوزيع، فراجع العثور على رمز الخطأ.

إذا لم يكن رمز الخطأ مدرجاً، فأرسل مشكلة GitHub. على الجانب الأيمن من الصفحة، حدد Feedback. في الجزء السفلي من الصفحة، ضمن Feedback حدد This page. قدِّم ملاحظاتك على الوثائق ولكن لا تُضمِّن معلومات سرية لأن مشكلات GitHub عامة.

رموز الخطأ

التعليمة البرمجية للخطأ التخفيف من المخاطر مزيد من المعلومات
AccountNameInvalid اتبع إرشادات التسمية لحسابات التخزين. حل الأخطاء الخاصة بأسماء حسابات التخزين
AccountPropertyCannotBeSet فحص خصائص حساب التخزين المتاحة. storageAccounts
AllocationFailed نظام المجموعة أو المنطقة ليس لديها موارد متاحة أو لا يمكنها دعم حجم الجهاز الظاهري المطلوب. أعد محاولة الطلب في وقت لاحق، أو اطلب حجم VM مختلف. مشكلات التزويد والتخصيص لنظام Linux

مشكلات التزويد والتخصيص لنظام Windows

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

قد تتلقى هذا الخطأ عندما لا يكون موفر الموارد المطلوب مسجلاً.
التحكم في Azure role-based access (Azure RBAC)

حل التسجيل
BadRequest لقد أرسلت قيم نشر لا تتطابق مع ما يتوقعه Azure Resource Manager. تحقق من رسالة الحالة الداخلية للمساعدة في استكشاف الأخطاء وإصلاحها.

تحقق من صحة بناء جملة القالب لحل أخطاء التوزيع عند استخدام قالب تم تصديره من مورد Azure موجود.
مرجع القالب

موقع المورد في قالب ARM

موقع المورد في ملف Bicep

حل النموذج غير الصالح
تعارض أنت تطلب عملية غير مسموح بها في الحالة الحالية للمورد. على سبيل المثال، لا يُسمح بتغيير حجم القرص إلا عند إنشاء جهاز ظاهري أو عند إلغاء تخصيص الجهاز الظاهري.
DeploymentActiveAndUneditable انتظر حتى يكتمل التوزيع المتزامن لمجموعة الموارد هذه.
DeploymentFailedCleanUp عندما تُوزع في الوضع الكامل، تُحْذَف أي موارد غير موجودة في القالب. يظهر لك هذا الخطأ عندما لا يكون لديك أذونات وصول كافية لحذف جميع الموارد غير الموجودة في القالب. لتجنب الخطأ، غيّر وضع التوزيع إلى وضع تزايدي. أوضاع توزيع Azure Resource Manager
DeploymentNameInvalidCharacters لا يمكن أن يحتوي اسم التوزيع إلا على أحرف أو أرقام أو واصلة (-)أو نقطة (.) أو شرطة سفلية (_).
DeploymentNameLengthLimitExceeded أسماء النشر محددة بـ 64 حرف.
DeploymentFailed خطأ DeploymentFailed هو خطأ عام لا يوفر التفاصيل التي تحتاجها لحل الخطأ. ابحث في تفاصيل الخطأ باستخدام رمز الخطأ الذي يوفر مزيداً من المعلومات. البحث عن رمز الخطأ
DeploymentQuotaExceeded إذا وصلت إلى حد 800 عملية نشر لكل مجموعة موارد، فاحذف عمليات النشر التي لم تعد مطلوبة من المحفوظات. حل الخطأ عندما يتجاوز عدد عمليات النشر 800
DeploymentJobSizeExceeded تبسيط القالب الخاص بك لتقليل الحجم. حل أخطاء حجم القالب
DnsRecordInUse يجب أن يكون اسم سجل DNS فريداً. أدخل اسماً مختلفاً.
ImageNotFound تحقق من إعدادات الصورة VM.
InaccessibleImage فشل نشر مثيل حاوية Azure. قد تحتاج إلى تضمين علامة الصورة مع بناء الجملة registry/image:tag لنشر الحاوية. بالنسبة إلى سجل خاص، تحقق من صحة بيانات الاعتماد الخاصة بك. البحث عن رمز الخطأ
InternalServerError بسبب مشكلة مؤقتة. أعد محاولة التوزيع.
InUseSuNET.CannotBeDeleted يمكن أن يحدث هذا الخطأ عند محاولة تحديث مورد، إذا تم حذف عملية الطلب وإنشاء المورد. تأكد من تحديد جميع القيم التي لم تتغير. تحديث المورد
InvalidAuthenticationTokenTenant الحصول على رمز مميز للوصول للمستأجر المناسب. يمكنك فقط الحصول على الرمز المميز للوصول من المستأجر الذي ينتمي إليه حسابك.
InvalidContentLink من المرجح أنك حاولت الارتباط بقالب متداخل غير متوفر. تحقق مرة أخرى من URI الذي قدمته للقالب المتداخل. إذا كان القالب موجوداً في حساب تخزين، فتأكد من إمكانية الوصول إلى URI. قد تحتاج إلى تمرير رمز SAS المميز. حالياً، لا يمكنك الارتباط بنموذج موجود في حساب تخزين خلف جدار حماية Azure Storage. ضع في اعتبارك نقل نموذجك إلى مستودع آخر، مثل GitHub. قوالب ARM المرتبطة والمتداخلة

وحدات Bicep
InvalidDeploymentLocation عند النشر على مستوى الاشتراك، تكون قد قدمت موقعاً مختلفاً لاسم النشر المُستخدم مسبقاً. توزيع اشتراك قالب ARM

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

⁩معلمات Bicep⁧
InvalidRequestContent تتضمن قيم النشر إما قيماً لم يُتعرف عليها أو أن القيم المطلوبة مفقودة. أَكِّد القيم الخاصة بنوع المورد الخاص بك. مرجع القالب
InvalidRequestFormat مَكِّن تسجيل تتبع الأخطاء عند تشغيل النشر، وتحقق من محتويات الطلب. تسجيل التصحيح
InvalidResourceLocation حدد اسماً فريداً لحساب التخزين. حل الأخطاء الخاصة بأسماء حسابات التخزين
InvalidResourceNamespace تحقق من مساحة اسم المورد التي حددتها في خاصية النوع . مرجع القالب
InvalidResourceReference المورد إما غير موجود حتى الآن أو أُشيرَ إليه بشكل غير صحيح. تحقق مما إذا كنت بحاجة إلى إضافة تبعية. تحقق من أن استخدامك لدالة المرجع يتضمن المعلمات المطلوبة للسيناريو الخاص بك. حل التبعيات
InvalidResourceType تحقق من نوع المورد الذي حددته في خاصية النوع. مرجع القالب
InvalidSubscriptionRegistrationState سجل اشتراكك مع مزود الموارد. حل التسجيل
InvalidTemplateDeployment
InvalidTemplate
تحقق من بنية القالب الخاص بك بحثاً عن أخطاء. حل النموذج غير الصالح
InvalidTemplateCircularDependency إزالة التبعيات غير الضرورية. حل التبعيات الدائرية
JobSizeExceeded تبسيط القالب الخاص بك لتقليل الحجم. حل أخطاء حجم القالب
LinkedAuthorizationFailed تحقق مما إذا كان حسابك ينتمي إلى نفس المستأجر مثل مجموعة الموارد التي تنشُر إليها.
LinkedInvalidPropertyId لم يتم حل معرّف المورد للمورد. تحقق من أنك قدمت جميع القيم المطلوبة لمعرف المورد. على سبيل المثال، معرف الاشتراك واسم مجموعة الموارد ونوع المورد واسم المورد الأصل (إذا لزم الأمر) واسم المورد. حل الأخطاء الخاصة باسم المورد ونوعه
LocationRequired توفير موقع للمورد. موقع المورد في قالب ARM

موقع المورد في ملف Bicep
MismatchingResourceSegments تأكد من احتواء المورد المتداخل على العدد الصحيح للقطاعات في الاسم والنوع. حل قطاعات الموارد
MissingRegistrationForLocation تحقق من حالة تسجيل موفر الموارد والمواقع المدعومة. حل التسجيل
MissingSubscriptionRegistration سجل اشتراكك مع مزود الموارد. حل التسجيل
NoRegisteredProviderFound تحقق من حالة تسجيل موفر الموارد. حل التسجيل
NotFound ربما تحاول نشر مورد تابع بالتوازي مع مورد أصل. تحقق مما إذا كنت بحاجة إلى إضافة تبعية. حل التبعيات
OperationNotAllowed يمكن أن يكون هناك عدة أسباب لرسالة الخطأ هذه.

1. يحاول التوزيع عملية غير مسموح بها على spcecified SKU.

2. يحاول التوزيع عملية تتجاوز الحصة النسبية للاشتراك أو مجموعة الموارد أو المنطقة. إذا أمكن، فراجع النشر الخاص بك للبقاء ضمن الحصص النسبية. خلافاً لذلك، ضع في اعتبارك طلب تغيير حصصك النسبية.
حل الحصص النسبية
OperationNotAllowedOnVMImageAsVMsBeingProvisioned قد تحاول حذف صورة تستخدم حاليا لتوفير الأجهزة الظاهرية. لا يمكنك حذف صورة يتم استخدامها من قبل أي جهاز ظاهري أثناء عملية التوزيع. أعد محاولة عملية حذف الصورة بعد اكتمال نشر الجهاز الظاهري.
ParentResourceNotFound تأكد من وجود المورد الأصل قبل إنشاء الموارد التابعة. حل المورد الأصل
PasswordTooLong ربما تكون قد حددت كلمة مرور بها عدد كبير جداً من الأحرف، أو حوَّلت قيمة كلمة المرور الخاصة بك إلى سلسلة آمنة قبل تمريرها كمعلمة. إذا احتوى القالب على معلمة سلسلة آمنة، فلن تحتاج إلى تحويل القيمة إلى سلسلة آمنة. توفير قيمة كلمة المرور كنص.
PrivateIPAddressInReservedRange يتضمن عنوان IP المُحدد نطاق العناوين المطلوب بواسطة Azure. غَيِّر عنوان IP لتجنب النطاق المحجوز. ⁩Private IP addresses⁦
PrivateIPAddressNotInSuNET. عنوان IP المُحدد خارج نطاق الشبكة الفرعية. غَيِّر عنوان IP ليقع ضمن نطاق الشبكة الفرعية. ⁩Private IP addresses⁦
PropertyChangeNotAllowed لا يمكن تغيير بعض الخصائص في مورد منشور. عند تحديث مورد، قيّد التغييرات على الخصائص المسموح بها. تحديث المورد
PublicIPCountLimitReached لقد وصلت إلى الحد الأقصى لعدد عناوين IP العامة التي يتم تشغيلها. قم بإيقاف تشغيل الموارد غير الضرورية أو اتصل بدعم Azure لطلب زيادة. على سبيل المثال؛ في Azure Databricks، راجع إنهاء غير متوقع للمجموعة ويمنع حد عنوان IP إنشاء المجموعة. حدود عنوان IP العام
RegionDoesNotAllowProvisioning حدد منطقة مختلفة أو أرسل طلب دعم حصة نسبية للوصول إلى المنطقة.
RequestDisallowedByPolicy يتضمن اشتراكك نهج موارد يمنع أي إجراء تحاول القيام به أثناء التوزيع. ابحث عن النهج التي تمنع الإجراء. إذا كان ذلك ممكناً، فغيّر النشر الخاص بك لتلبية قيود النهج. حل النُهج
ReservedResourceName أدخل اسم مورد لا يتضمن اسماً محجوزاً. أسماء الموارد المحجوزة
ResourceGroupBeingDeleted انتظر حتى يكتمل الحذف.
ResourceGroupNotFound تحقق من اسم مجموعة الموارد الهدف للنشر. يجب أن تكون مجموعة الموارد الهدف موجودة بالفعل في اشتراكك. تحقق من سياق اشتراكك. Azure CLIPowerShell
ResourceNotFound يشير لنشر إلى مورد لا يمكن حله. تحقق من أن استخدامك لدالة المرجع يتضمن المعلمات المطلوبة للسيناريو الخاص بك. حل المراجع
ResourceQuotaExceeded يحاول النشر إنشاء موارد تتجاوز الحصة النسبية للاشتراك أو مجموعة الموارد أو المنطقة. إذا كان ذلك ممكناً، فراجع البنية الأساسية للبقاء ضمن الحصص النسبية. خلافاً لذلك، ضع في اعتبارك طلب تغيير حصصك النسبية. حل الحصص النسبية
SkuNotAvailable حدد SKU (مثل حجم الجهاز الظاهري) المتاح للموقع المُحدد. حل SKU
StorageAccountAlreadyTaken
StorageAccountAlreadyExists
حدد اسماً فريداً لحساب التخزين. حل الأخطاء الخاصة بأسماء حسابات التخزين
StorageAccountInAnotherResourceGroup حدد اسماً فريداً لحساب التخزين. حل الأخطاء الخاصة بأسماء حسابات التخزين
StorageAccountNotFound تحقق من الاشتراك ومجموعة الموارد واسم حساب التخزين الذي تحاول استخدامه.
SubnetsNotInSameNET. يمكن أن يكون لدى الجهاز الظاهري شبكة ظاهرية واحدة فقط. عند نشر عدة NICs، تأكد من أنها تنتمي إلى نفس الشبكة الظاهرية. بطاقات NIC متعددة لجهاز Windows الظاهري

بطاقات NIC متعددة لجهاز Linux الظاهري
SubnetIsFull لا توجد عناوين متوفرة كافية في الشبكة الفرعية لتوزيع الموارد. يمكنك تحرير العناوين من الشبكة الفرعية أو استخدام شبكة فرعية مختلفة أو إنشاء شبكة فرعية جديدة. إدارة الشبكات الفرعية والأسئلة المتداولة عن الشبكة الظاهرية

⁩Private IP addresses⁦
SubscriptionNotFound لا يمكن الوصول إلى اشتراك محدد للنشر. قد يكون مُعرّف الاشتراك خاطئاً، أو أن المستخدم الذي ينشر القالب ليس لديه أذونات كافية للنشر في الاشتراك، أو أن مُعرّف الاشتراك بتنسيق خاطئ. عند استخدام عمليات توزيع متداخلة لقالب ARM للتوزيع عبر النطاقات، قم بتوفير معرف فريد للاشتراك. توزيع قالب ARM عبر النطاقات

توزيع ملف Bicep عبر النطاقات
SubscriptionNotRegistered عند نشر مورد، يتعين تسجيل موفر المورد لاشتراكك. عند استخدام قالب Azure Resource Manager للنشر، يُسجل موفر المورد تلقائياً في الاشتراك. في بعض الأحيان، لا يكتمل التسجيل التلقائي في الوقت المناسب. لتجنب هذا الخطأ المتقطع، سجّل موفر المورد قبل النشر. حل التسجيل
SubscriptionRequestsThrottled يقيد Azure Resource Manager الطلبات على مستوى الاشتراك أو مستوى المستأجر. موفرو الموارد مثل Microsoft.Compute أيضا تقييد الطلبات الخاصة بعملياتها.

عند الوصول إلى حد، تحصل على رسالة وقيمة مع مقدار الوقت الذي يجب الانتظار قبل إرسال طلب جديد. على سبيل المثال:Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds.

ترجع استجابة HTTP رسالة مثل HTTP status code 429 Too Many Requests بقيمة Retry-After تحدد عدد الثوان التي يجب انتظارها قبل إرسال طلب آخر.
طلبات إدارة الموارد المقيدة

استكشاف أخطاء تقييد واجهة برمجة التطبيقات وإصلاحها - الأجهزة الظاهرية

تقييد خدمة Azure Kubernetes
TemplateResourceCircularDependency إزالة التبعيات غير الضرورية. حل التبعيات الدائرية
TooManyTargetResourceGroups تقليل عدد مجموعات الموارد لعملية نشر واحدة. توزيع قالب ARM عبر النطاقات

توزيع ملف Bicep عبر النطاقات

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