مشاركة عبر

الحصول على نقاط آمنة للجهاز

  • مقالة

ينطبق على:

هل تريد تجربة 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

استرداد درجة الأمان من Microsoft للأجهزة. تعني درجة الأمان الأعلى من Microsoft للأجهزة أن نقاط النهاية الخاصة بك أكثر مرونة من هجمات تهديدات الأمان عبر الإنترنت.

الأذونات

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

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

طلب HTTP

GET /api/configurationScore

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

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

نص الطلب

فارغه

استجابه

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

المثال

مثال على الطلب

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

GET https://api.securitycenter.microsoft.com/api/configurationScore

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

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

ملاحظة

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

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}

راجع أيضًا

تلميح

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