قائمة الأجهزة API

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

استرداد مجموعة من الأجهزة التي تواصلت مع Microsoft Defender لنقطة النهاية.

يدعم استعلامات OData V4. عوامل تشغيل OData المدعومة:

• $filter على الخصائص التالية:
  • computerDnsName
  • id
  • version
  • deviceValue
  • aadDeviceId
  • machineTags
  • lastSeen
  • exposureLevel
  • onboardingStatus
  • lastIpAddress
  • healthStatus
  • osPlatform
  • riskScore
  • rbacGroupId
• $top بقيمة قصوى تبلغ 10,000.
• $skip

راجع الأمثلة في استعلامات OData باستخدام Defender لنقطة النهاية

القيود

• يمكنك رؤية الأجهزة آخر مرة وفقا لفترة الاستبقاء التي تم تكوينها.
• الحد الأقصى لحجم الصفحة هو 10,000.
• قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 مكالمة في الساعة.

الأذونات

عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم، يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: View Data. لمزيد من المعلومات، راجع: إنشاء الأدوار وإدارتها.

تتضمن الاستجابات الأجهزة التي يمكن للمستخدم الوصول إليها فقط، استنادا إلى إعدادات مجموعة الأجهزة. لمزيد من المعلومات، راجع: إنشاء مجموعات الأجهزة وإدارتها.

نوع الإذن	اذن	اسم عرض الإذن
Application	Machine.ReadWrite.All	'قراءة جميع معلومات الجهاز وكتابتها'
مفوض (حساب العمل أو المؤسسة التعليمية)	Machine.ReadWrite	"قراءة وكتابة معلومات الجهاز"

طلب HTTP

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

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

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

نص الطلب

فارغه

استجابه

إذا نجحت، وكانت الأجهزة موجودة، فسترى 200 OK مع قائمة كيانات الجهاز في النص الأساسي. إذا لم تكن هناك أجهزة حديثة، فسترى 404 Not Found.

المثال

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

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

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

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

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

HTTP/1.1 200 OK
Content-type: application/json
{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Machines",
    "value": [
        {
            "id": "1e5bc9d7e413ddd7902c2932e418702b84d0cc07",
            "computerDnsName": "mymachine1.contoso.com",
            "firstSeen": "2018-08-02T14:55:03.7791856Z",
            "lastSeen": "2018-08-02T14:55:03.7791856Z",
            "osPlatform": "Windows10" "Windows11",
            "version": "1709",
            "osProcessor": "x64",
            "lastIpAddress": "172.17.230.209",
            "lastExternalIpAddress": "167.220.196.71",
            "osBuild": 18209,
            "healthStatus": "Active",
            "rbacGroupId": 140,
            "rbacGroupName": "The-A-Team",
            "riskScore": "Low",
            "exposureLevel": "Medium",
            "isAadJoined": true,
            "aadDeviceId": "80fe8ff8-2624-418e-9591-41f0491218f9",
            "machineTags": [ "test tag 1", "test tag 2" ]
        }
        ...
    ]
}