تشغيل واجهة برمجة تطبيقات فحص مكافحة الفيروسات
ينطبق على:
- الخطة 1 من Microsoft Defender لنقطة النهاية
- Defender for Endpoint الخطة 2
- Microsoft Defender for Business
هل تريد تجربة Defender لنقطة النهاية؟ التسجيل للحصول على إصدار تجريبي مجاني.
ملاحظة
إذا كنت أحد عملاء حكومة الولايات المتحدة، فالرجاء استخدام معرفات URI المدرجة في Microsoft Defender لنقطة النهاية لعملاء حكومة الولايات المتحدة.
تلميح
للحصول على أداء أفضل، يمكنك استخدام الخادم الأقرب إلى موقعك الجغرافي:
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
وصف واجهة برمجة التطبيقات
بدء فحص برنامج الحماية من الفيروسات Microsoft Defender على جهاز.
القيود
- قيود المعدل لواجهة برمجة التطبيقات هذه هي 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.