مشاركة عبر

الحصول على نقاط التعرض للضوء

  • مقالة

ينطبق على:

هل تريد تجربة 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 أي ضمانات، يتم التعبير عنها أو تضمينها، فيما يتعلق بالمعلومات المقدمة هنا.

استرداد درجة التعرض التنظيمي.

الأذونات

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

نوع الإذن إذن اسم عرض الإذن
Application Score.Read.All 'قراءة درجة إدارة المخاطر والثغرات الأمنية'
مفوض (حساب العمل أو المؤسسة التعليمية) Score.Read 'قراءة درجة إدارة المخاطر والثغرات الأمنية'

طلب HTTP

GET /api/exposureScore

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

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

نص الطلب

أجوف

استجابه

إذا نجحت، ترجع هذه الطريقة 200 موافق، مع بيانات التعرض في نص الاستجابة.

مثل

طلب

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

GET https://api.security.microsoft.com/api/exposureScore

استجابه

فيما يلي مثال على الاستجابة.

ملاحظة

قد يتم اقتطاع قائمة الاستجابة الموضحة هنا للإيجاز.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#ExposureScore/$entity",
    "time": "2019-12-03T07:23:53.280499Z",
    "score": 33.491554051195706
}

راجع أيضًا

تلميح

هل تريد معرفة المزيد؟ التفاعل مع مجتمع أمان Microsoft في مجتمع التكنولوجيا لدينا: Microsoft Defender for Endpoint Tech Community.