قائمة الأجهزة API
ينطبق على:
هل تريد تجربة 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 Defender لنقطة النهاية.
يدعم استعلامات OData V4.
يتم دعم استعلام OData $filter
في: computerDnsName
و id
version
و deviceValue
و aadDeviceId
و.rbacGroupId
machineTags
lastSeen
exposureLevel
onboardingStatus
lastIpAddress
healthStatus
osPlatform
riskScore
$top
بقيمة قصوى تبلغ 10,000$skip
راجع الأمثلة في استعلامات OData باستخدام Defender لنقطة النهاية
القيود
- يمكنك رؤية الأجهزة آخر مرة وفقا لفترة الاستبقاء التي تم تكوينها.
- الحد الأقصى لحجم الصفحة هو 10,000.
- قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.
الأذونات
نوع الإذن | اذن | اسم عرض الإذن |
---|---|---|
Application | Machine.Read.All | 'قراءة جميع ملفات تعريف الجهاز' |
Application | Machine.ReadWrite.All | 'قراءة جميع معلومات الجهاز وكتابتها' |
مفوض (حساب العمل أو المؤسسة التعليمية) | Machine.Read | "قراءة معلومات الجهاز" |
مفوض (حساب العمل أو المؤسسة التعليمية) | Machine.ReadWrite | "قراءة وكتابة معلومات الجهاز" |
ملاحظة
عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:
- يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: "عرض البيانات" (لمزيد من المعلومات، راجع الإنشاء الأدوار وإدارتها)
- ستتضمن الاستجابة الأجهزة فقط، التي يمكن للمستخدم الوصول إليها، استنادا إلى إعدادات مجموعة الأجهزة (لمزيد من المعلومات، راجع الإنشاء مجموعات الأجهزة وإدارتها)
يتم دعم إنشاء مجموعة الأجهزة في خطة Defender لنقطة النهاية 1 والخطة 2.
طلب HTTP
GET https://api.security.microsoft.com/api/machines
عناوين الطلبات
الاسم | نوع | الوصف |
---|---|---|
التخويل | سلسلة | الحامل {token}. مطلوب. |
نص الطلب
فارغه
استجابه
إذا نجحت وكانت الأجهزة موجودة - 200 موافق مع قائمة كيانات الجهاز في النص الأساسي. إذا لم يتم العثور على أجهزة حديثة - 404 غير موجود.
المثال
مثال على الطلب
فيما يلي مثال على الطلب.
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" ]
}
...
]
}
المقالات ذات الصلة
تلميح
هل تريد معرفة المزيد؟ Engage مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender لنقطة النهاية Tech Community.
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ