معالجة أخطاء واجهة برمجة تطبيقات REST
تنقسم استجابات خطأ HTTP إلى فئتين:
- خطأ العميل (مستوى التعليمات البرمجية 400) - أرسل العميل طلبا غير صالح أو أن الطلب لا يتوافق مع التعريفات.
- خطأ في الخادم (500 مستوى) - فشل الخادم مؤقتا في تلبية الطلب أو حدث خطأ في الخادم. حاول إرسال طلب HTTP مرة أخرى.
قد يتم إرجاع رموز الخطأ المدرجة في الجدول التالي بواسطة عملية على أي من واجهات برمجة التطبيقات Microsoft Defender لنقطة النهاية.
- بالإضافة إلى رمز الخطأ، تحتوي كل استجابة خطأ على رسالة خطأ، والتي يمكن أن تساعد في حل المشكلة.
- الرسالة عبارة عن نص مجاني يمكن تغييره.
- في أسفل الصفحة، يمكنك العثور على أمثلة الاستجابة.
ينطبق على:
هل تريد تجربة Defender لنقطة النهاية؟ التسجيل للحصول على إصدار تجريبي مجاني.
| رمز الخطأ | رمز حالة HTTP | رساله |
|---|---|---|
| طلب غير مبسط | BadRequest (400) | رسالة خطأ طلب غير صحيح عام. |
| ODataError | BadRequest (400) | استعلام OData URI غير صحيح (تم تحديد الخطأ المحدد). |
| معدل استخدام غير صالح | BadRequest (400) | إدخال غير صحيح {الإدخال غير صالح}. |
| InvalidRequestBody | BadRequest (400) | نص الطلب غير صحيح. |
| InvalidHashValue | BadRequest (400) | قيمة التجزئة {التجزئة غير الصالحة} غير صحيحة. |
| InvalidDomainName | BadRequest (400) | اسم المجال {المجال غير صالح} غير صحيح. |
| InvalidIpAddress | BadRequest (400) | عنوان IP {عنوان IP غير صالح} غير صحيح. |
| InvalidUrl | BadRequest (400) | URL {عنوان URL غير صحيح} غير صحيح. |
| MaximumBatchSizeExceeded | BadRequest (400) | تم تجاوز الحد الأقصى لحجم الدفعة. تم الاستلام: {batch size received}، مسموح به: {batch size allowed}. |
| MissingRequiredParameter | BadRequest (400) | المعلمة {المعلمة المفقودة} مفقودة. |
| OsPlatformNotSupported | BadRequest (400) | نظام التشغيل الأساسي {النظام الأساسي لنظام التشغيل العميل} غير مدعوم لهذا الإجراء. |
| ClientVersionNotSupported | BadRequest (400) | {الإجراء المطلوب} مدعوم على إصدار العميل {supported client version} والإصدارات الأحدث. |
| غير المصرح به | غير مصرح به (401) | غير مصرح به (عنوان تخويل غير صالح أو منتهية الصلاحية). |
| المحرمه | ممنوع (403) | ممنوع (رمز مميز صالح ولكن إذن غير كاف للإجراء). |
| DisabledFeature | ممنوع (403) | لم يتم تمكين ميزة المستأجر. |
| إلغاء السماح بالتشغيل | ممنوع (403) | {العملية غير المسموح بها والسبب}. |
| NotFound | غير موجود (404) | رسالة خطأ General Not Found. |
| ResourceNotFound | غير موجود (404) | لم يتم العثور على المورد {المورد المطلوب}. |
| طلبات TooMany | طلبات كثيرة جدا (429) | تمثل الاستجابة الوصول إلى حد الحصة النسبية إما حسب عدد الطلبات أو بواسطة وحدة المعالجة المركزية. |
| InternalServerError | خطأ داخلي في الخادم (500) | (لا توجد رسالة خطأ، أعد محاولة العملية.) |
اختناق
قد يتلقى عميل HTTP خطأ "طلبات كثيرة جدا (429)" عندما يتجاوز عدد طلبات HTTP في إطار زمني معين العدد المسموح به من المكالمات لكل واجهة برمجة تطبيقات.
يجب أن يؤخر عميل HTTP إعادة إرسال المزيد من طلبات HTTPS ثم إرسالها بطريقة تتوافق مع قيود المعدل. Retry-After في عنوان الاستجابة يشير إلى المدة التي يجب الانتظار فيها (بالثوان) قبل تقديم طلب جديد
يؤدي تجاهل الاستجابة 429 أو محاولة إعادة إرسال طلبات HTTP في إطار زمني أقصر إلى إرجاع رمز الخطأ 429.
معلمات النص الأساسي حساسة لحالة الأحرف
معلمات النص المرسل حساسة لحالة الأحرف حاليا.
إذا واجهت أخطاء InvalidRequestBody أو MissingRequiredParameter ، فقد يحدث ذلك من رأس مال معلمة خاطئ أو حرف صغير.
راجع صفحة وثائق واجهة برمجة التطبيقات وتحقق من أن المعلمات المرسلة تطابق المثال ذي الصلة.
معرف طلب الارتباط
تحتوي كل استجابة خطأ على معلمة معرف فريدة للتعقب.
اسم الخاصية لهذه المعلمة هو "الهدف".
عند الاتصال بنا حول خطأ، يساعد إرفاق هذا المعرف في العثور على السبب الجذري للمشكلة.
أمثلة
{
"error": {
"code": "ResourceNotFound",
"message": "Machine 123123123 was not found",
"target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
}
}
{
"error": {
"code": "InvalidRequestBody",
"message": "Request body is incorrect",
"target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
}
}
تلميح
هل تريد معرفة المزيد؟ Engage مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender لنقطة النهاية Tech Community.