رموز خطأ واجهة برمجة تطبيقات 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 Graph - Microsoft Graph | Microsoft Learn
- نظرة عامة على واجهات برمجة التطبيقات Microsoft Defender XDR
- واجهات برمجة تطبيقات Microsoft Defender XDR المعتمدة
- الوصول إلى واجهات برمجة التطبيقات Microsoft Defender XDR
- تعرف على حدود واجهة برمجة التطبيقات والترخيص
تلميح
هل تريد معرفة المزيد؟ تفاعل مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender XDR Tech Community.