حل أخطاء الموارد غير موجودة

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

أعراض

هناك رمزي خطأ يشيران إلى تعذر العثور على المورد. يرجع الخطأ NotFound نتيجة مشابهة لما يلي:

Code=NotFound;
Message=Cannot find ServerFarm with name exampleplan.

يرجع الخطأ ResourceNotFound نتيجة مشابهة لما يلي:

Code=ResourceNotFound;
Message=The Resource 'Microsoft.Storage/storageAccounts/{storage name}' under resource
group {resource group name} was not found.

السبب

يحتاج Resource Manager إلى استرداد خصائص أحد الموارد، ولكن لا يمكنه العثور على المورد في اشتراكك.

الحل 1: تحقق من خصائص المورد

عندما تتلقى هذا الخطأ أثناء القيام بمهمة إدارة، تحقق من القيم التي توفرها للمورد. قيم التحقق الثلاث هي:

• اسم المورد
• اسم مجموعة الموارد
• الاشتراك

إذا كنت تستخدم PowerShell أو Azure CLI، فتحقق من أنك تقوم بتشغيل الأوامر في الاشتراك الذي يحتوي على المورد. يمكنك تغيير الاشتراك مع Set-AzContext أو مجموعة حسابات az. توفر العديد من الأوامر معلمة اشتراك تتيح لك تحديد اشتراك مختلف عن السياق الحالي.

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

الحل 2: تعيين التبعيات

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

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

Bicep

استخدم تبعية ضمنية بدلاً من الدالة resourceId. يتم إنشاء التبعية باستخدام اسم المورد الرمزي وخاصية المعرّف.

على سبيل المثال، تستخدم الخاصية serverFarmId لتطبيق الويب servicePlan.id لإنشاء تبعية على خطة خدمة التطبيق.

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  properties: {
    serverFarmId: servicePlan.id
  }
}

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  ...

بالنسبة لمعظم عمليات التوزيع، ليس من الضروري استخدام dependsOn لإنشاء تبعية صريحة.

تجنب تعيين التبعيات غير المطلوبة. تعمل التبعيات غير الضرورية على إطالة مدة التوزيع حيث لا يتم توزيع الموارد بالتوازي. وأيضاً، يمكنك إنشاء تبعيات دائرية تمنع التوزيع.

JSON

إذا كان يجب توزيع مورد بعد مورد آخر، استخدم عنصر dependsOn في القالب الخاص بك.

{
  "type": "Microsoft.Web/sites",
  "apiVersion": "2022-03-01",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  ...
}

تجنب تعيين التبعيات غير المطلوبة. تعمل التبعيات غير الضرورية على إطالة مدة التوزيع حيث لا يتم توزيع الموارد بالتوازي. وأيضاً، يمكنك إنشاء تبعيات دائرية تمنع التوزيع.

تقوم الدالة المرجعية ودالات القائمة* بإنشاء تبعية ضمنية على المورد المُشار إليه، عند توزيع هذا المورد في نفس القالب ويُشار إليه باسمه (ليس معرّف المورد). لذلك، قد تكون لديك تبعيات أكثر من التبعيات المحددة في الخاصية dependsOn.

لا تنشئ دالة resourceId تبعية ضمنية أو تحقق من وجود المورد. لا تنشئ الدالة المرجعية و دالات القائمة* تبعية ضمنية عند الإشارة إلى المورد بواسطة معرّف مورده. لإنشاء تبعية ضمنية، قم بتمرير اسم المورد الذي تم توزيعه في نفس القالب.

ترتيب التوزيع

عند رؤيتك مشاكل في التبعية، ستحتاج إلى الحصول على نتيجة معرفية لترتيب توزيع الموارد. يمكنك استخدام المدخل لعرض ترتيب عمليات التوزيع:

1. الانتقال إلى المدخل.

2. من نظرة عامة على مجموعة الموارد، حدد الارتباط لمحفوظات التوزيع.

   

3. بالنسبة لاسم التوزيع الذي تريد مراجعته، حدد "Related events".

   

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

   

   تعرض الصورة التالية ثلاثة حسابات تخزين لا يتم توزيعها بالتوازي. يعتمد حساب التخزين الثاني على حساب التخزين الأول، ويعتمد حساب التخزين الثالث على حساب التخزين الثاني. تتم تسمية حساب التخزين الأول Started، وAccepted، وSucceeded قبل بدء تشغيل التالي.

   

الحل 3: الحصول على موارد خارجية

Bicep

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

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

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' existing = {
  name: hostingPlanName
  scope: resourceGroup(rgname)
}

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  name: siteName
  properties: {
    serverFarmId: servicePlan.id
  }
}

JSON

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

معلمات الاشتراك ومجموعة الموارد في الدالة resourceId اختيارية. إذا لم تقم بتوفيرها، فإنها تكون افتراضية للاشتراك الحالي ومجموعة الموارد. عند العمل مع مورد في مجموعة موارد أو اشتراك مختلف، تأكد من توفير هذه القيم.

يحصل المثال التالي على معرف المورد لمورد موجود في مجموعة موارد مختلفة.

"properties": {
  "name": "[parameters('siteName')]",
  "serverFarmId": "[resourceId('plangroup', 'Microsoft.Web/serverfarms', parameters('hostingPlanName'))]"
}

الحل 4: الحصول على هوية مدارة من المورد

Bicep

إذا كنت توزع مورداً باستخدام هوية مُدارةضمنياً، فيجب الانتظار حتى يتم توزيع هذا المورد قبل استرداد القيم على الهوية المُدارة. استخدم تبعية ضمنية للمورد الذي يتم تطبيق الهوية عليه. يضمن هذا النهج توزيع المورد والهوية المُدارة قبل أن يستخدم Resource Manager التبعية.

يمكنك الحصول على المعرّف الرئيسي ومعرّف المستأجر لهوية مُدارة يتم تطبيقها على جهاز ظاهري. على سبيل المثال، إذا كان لمورد جهاز ظاهري اسم رمزي لـ vm، فاستخدم بناء الجملة التالية:

vm.identity.principalId

vm.identity.tenantId

JSON

إذا كنت توزع مورداً باستخدام هوية مُدارةضمنياً، فيجب الانتظار حتى يتم توزيع هذا المورد قبل استرداد القيم على الهوية المُدارة. إذا قمت بتمرير اسم الهوية المدارة إلى الدالة مرجع، فسيحاول Azure Resource Manager لحل المرجع قبل توزيع المورد والهوية. بدلًا من ذلك، قم بتمرير اسم المورد الذي يتم تطبيق الهوية. يضمن هذا النهج المورد ويتم توزيع الهوية المُدارة قبل حل Azure Resource Manager للدالة المرجعية.

في الدالة «مرجع»، استخدم Full للحصول على كافة الخصائص، بما في ذلك الهوية المُدارة.

النمط هو:

"[reference(resourceId(<resource-provider-namespace>, <resource-name>), <API-version>, 'Full').Identity.propertyName]"

هام

لا تستخدم النمط:

"[reference(concat(resourceId(<resource-provider-namespace>, <resource-name>),'/providers/Microsoft.ManagedIdentity/Identities/default'),<API-version>).principalId]"

سيفشل القالب.

على سبيل المثال، للحصول على معرف أساسي لهوية مُدارة يتم تطبيقها على جهاز ظاهري، استخدم:

"[reference(resourceId('Microsoft.Compute/virtualMachines', variables('vmName')), '2022-03-01', 'Full').identity.principalId]",

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

"[reference(resourceId('Microsoft.Compute/virtualMachineScaleSets',  variables('vmNodeType0Name')), '2022-03-01', 'Full').Identity.tenantId]"

الحل 5: التحقق من الدالات

Bicep

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

يرجع المثال التالي لحساب تخزين موجود في مجموعة موارد مختلفة.

resource stgAcct 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
  name: stgname
  scope: resourceGroup(rgname)
}

JSON

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

"[reference(resourceId('exampleResourceGroup', 'Microsoft.Storage/storageAccounts', 'myStorage'), '2022-05-01')]"

الحل 6: بعد حذف المورد

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

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