رموز خطأ واجهة برمجة تطبيقات REST Microsoft Defender XDR الشائعة

  • مقالة

ينطبق على:

  • Microsoft Defender XDR

ملاحظة

جرب واجهات برمجة التطبيقات الجديدة باستخدام واجهة برمجة تطبيقات أمان MS Graph. تعرف على المزيد في: استخدام واجهة برمجة تطبيقات أمان Microsoft Graph - Microsoft Graph | Microsoft Learn.

هام

تتعلق بعض المعلومات بالمنتج الذي تم إصداره مسبقا والذي قد يتم تعديله بشكل كبير قبل إصداره تجاريا. لا تقدم Microsoft أي ضمانات، سواءً كانت صريحة أم ضمنية، فيما يتعلق بالمعلومات الواردة هنا.

يمكن إرجاع رموز الخطأ عن طريق عملية على أي من واجهات برمجة التطبيقات Microsoft Defender XDR. تحتوي كل استجابة خطأ على رسالة خطأ، والتي يمكن أن تساعد في حل المشكلة. يوفر عمود رسالة الخطأ في قسم الجدول بعض نماذج الرسائل. يختلف محتوى الرسائل الفعلية استنادا إلى العوامل التي أدت إلى الاستجابة. تتم الإشارة إلى محتوى المتغير بواسطة أقواس الزاوية (< >) في الجدول التالي:

رموز الخطأ

رمز الخطأ رمز حالة 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 allowed}.
MissingRequiredParameter BadRequest (400) المعلمة <المعلمة> المفقودة مفقودة.
OsPlatformNotSupported BadRequest (400) نظام التشغيل الأساسي <النظام الأساسي العميل نظام التشغيل الأساسي> غير مدعوم لهذا الإجراء.
ClientVersionNotSupported BadRequest (400) <يتم دعم الإجراء> المطلوب على إصدار <العميل المدعوم بإصدار> العميل والإصدارات الأحدث.
غير المصرح به غير مصرح به (401) غير المصرح به

يحدث هذا الخطأ عادة بسبب عنوان تخويل غير صالح أو منتهية الصلاحية.
المحرمه ممنوع (403) المحرمه

يمكن أن يحدث هذا الخطأ برمز مميز صالح ولكن إذن غير كاف للإجراء.
DisabledFeature ممنوع (403) لم يتم تمكين ميزة المستأجر.
إلغاء السماح بالتشغيل ممنوع (403) <العملية غير المسموح بها والسبب>.
NotFound غير موجود (404) رسالة خطأ General Not Found.
ResourceNotFound غير موجود (404) المورد <لم يتم العثور على المورد> المطلوب.
InternalServerError خطأ داخلي في الخادم (500) إذا لم تكن هناك رسالة خطأ، فقم بإعادة محاولة العملية. اتصل ب Microsoft إذا لم يتم حلها.

أمثلة

{
    "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"
    }
}

معلمات النص الأساسي

هام

معلمات النص الأساسي حساسة لحالة الأحرف.

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

معرف التعقب

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

تلميح

هل تريد معرفة المزيد؟ تفاعل مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender XDR Tech Community.