مشاركة عبر

معالجة أخطاء واجهة برمجة تطبيقات 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.