تشغيل واجهة برمجة تطبيقات فحص مكافحة الفيروسات

  • مقالة

ينطبق على:

هل تريد تجربة Defender لنقطة النهاية؟ التسجيل للحصول على إصدار تجريبي مجاني.

ملاحظة

إذا كنت أحد عملاء حكومة الولايات المتحدة، فالرجاء استخدام معرفات URI المدرجة في Microsoft Defender لنقطة النهاية لعملاء حكومة الولايات المتحدة.

تلميح

للحصول على أداء أفضل، يمكنك استخدام الخادم الأقرب إلى موقعك الجغرافي:

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com
  • api-au.securitycenter.microsoft.com

وصف واجهة برمجة التطبيقات

بدء فحص برنامج الحماية من الفيروسات Microsoft Defender على جهاز.

القيود

  1. قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.

ملاحظة

تركز هذه الصفحة على تنفيذ إجراء جهاز عبر واجهة برمجة التطبيقات. راجع اتخاذ إجراءات الاستجابة على جهاز لمزيد من المعلومات حول وظائف إجراءات الاستجابة عبر Microsoft Defender لنقطة النهاية.

هام

  • يتوفر هذا الإجراء للأجهزة على Windows 10، الإصدار 1709 أو أحدث، وعلى Windows 11.
  • يمكن تشغيل فحص برنامج الحماية من الفيروسات Microsoft Defender جنبا إلى جنب مع حلول مكافحة الفيروسات الأخرى، سواء كان برنامج الحماية من الفيروسات Microsoft Defender هو حل مكافحة الفيروسات النشط أم لا. يمكن أن يكون برنامج الحماية من الفيروسات Microsoft Defender في الوضع السلبي. لمزيد من المعلومات، راجع توافق Microsoft Defender مكافحة الفيروسات.

الأذونات

أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع استخدام واجهات برمجة التطبيقات Microsoft Defender لنقطة النهاية

نوع الإذن اذن اسم عرض الإذن
Application Machine.Scan "جهاز الفحص"
مفوض (حساب العمل أو المؤسسة التعليمية) Machine.Scan "جهاز الفحص"

ملاحظة

عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:

يتم دعم إنشاء مجموعة الأجهزة في خطة Defender لنقطة النهاية 1 والخطة 2.

طلب HTTP

POST https://api.security.microsoft.com/api/machines/{id}/runAntiVirusScan

عناوين الطلبات

الاسم نوع الوصف
التخويل سلسلة الحامل {token}. مطلوب.
نوع المحتوى سلسله application/json

نص الطلب

في نص الطلب، قم بتوفير كائن JSON بالمعلمات التالية:

المعلمه نوع الوصف
التعليق سلسلة التعليق لإقرانه بالإجراء. مطلوب.
نوع الفحص سلسلة يحدد نوع الفحص. مطلوب.

يتحكم ScanType في نوع الفحص المطلوب تنفيذه ويمكن أن يكون أحد الإجراءات التالية:

  • سريع: إجراء فحص سريع على الجهاز
  • كامل: إجراء الفحص الكامل على الجهاز

استجابه

إذا نجحت، فترجع هذه الطريقة 201، التعليمات البرمجية للاستجابة التي تم إنشاؤها وعنصر MachineAction في نص الاستجابة.

إذا أرسلت استدعاءات واجهة برمجة تطبيقات متعددة لتشغيل فحص مكافحة الفيروسات لنفس الجهاز، فإنه يرجع "إجراء الجهاز المعلق" أو HTTP 400 مع الرسالة "الإجراء قيد التقدم بالفعل".

المثال

طلب

فيما يلي مثال على الطلب.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/runAntiVirusScan 

{
  "Comment": "Check machine for viruses due to alert 3212",
  "ScanType": "Full"
}

تلميح

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