الحصول على معرف عامل الفحص

مقالة
05/03/2024

ينطبق على:

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

هل تريد تجربة إدارة الثغرات الأمنية في Microsoft Defender؟ تعرف على كيفية التسجيل للحصول على نسخة تجريبية مجانية.

هام

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

ملاحظة

إذا كنت أحد عملاء حكومة الولايات المتحدة، فالرجاء استخدام معرفات 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

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

استرداد تفاصيل عامل محدد بواسطة معرفه.

القيود

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

الأذونات

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

نوع الإذن	إذن	اسم عرض الإذن
Application	Machine.Read.All	اقرأ جميع معلومات الفحص.
مفوض (حساب العمل أو المؤسسة التعليمية)	Machine.Read.All	اقرأ جميع معلومات الفحص.

ملاحظة

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

لعرض البيانات التي يحتاجها المستخدم للحصول على إذن الدور التالي على الأقل: "ViewData" أو "TvmViewData" (راجع إنشاء الأدوار وإدارتها لمزيد من المعلومات)

طلب HTTP

GET /api/DeviceAuthenticatedScanAgents

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

الاسم	نوع	الوصف
إذن	سلسلة	الحامل {token}. مطلوب.

نص الطلب

أجوف

استجابه

إذا نجحت، يقوم هذا الأسلوب بإرجاع التعليمات البرمجية للاستجابة 200 - OK مع تفاصيل العامل المحدد.

طلب مثال

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

GET https://api.security.microsoft.com/api/DeviceAuthenticatedScanAgents/7f3d76a6976818553e996875dc91f55df6b26625

مثال على الاستجابة

{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#DeviceAuthenticatedScanAgents/$entity",
    "value": [
    {
    "id": "47df41a0c-asad-4fd6d3-bbea-a93dbc0bfcaa_4edd75b2407a5b64d704b4e53d74f15",
    "machineId": "4ejh675b240118fbehiuiy5b64d704b4e53d15",
    "lastSeen": "2022-05-08T12:18:41.538203Z",
    "computerDnsName": "TEST_DOMAIN",
    "AssignedApplicationId": "9E0FA0EB-0A51-4357-9C87-C21BFBE07571",
    "ScannerSoftwareVersion": "7.1.1",
    "LastCommandExecutionTimestamp": "2022-05-08T12:18:41.538203Z",
    "mdeClientVersion": "10.8295.22621.1195"
    },
   ]
}