الحصول على واجهة برمجة تطبيقات إحصائيات الملفات

مقالة
02/20/2025

ينطبق على:

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

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

استرداد إحصائيات الملف المحدد.

القيود

قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.
الحد الأقصى لقيمة lookbackhours هو 720 ساعة (30 يوما).

الأذونات

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

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

ملاحظة

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

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

طلب HTTP

GET /api/files/{id}/stats

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

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

طلب معلمات URI

الاسم	نوع	الوصف
lookBackHours	Int32	يحدد الساعات التي نبحث فيها مرة أخرى للحصول على الإحصائيات. الإعدادات الافتراضية إلى 30 يوما. اختياري.

نص الطلب

أجوف

استجابه

إذا كان ناجحا وملف موجود - 200 موافق مع البيانات الإحصائية في النص الأساسي. إذا لم يكن الملف موجودا - 404 غير موجود.

مثل

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

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

GET https://api.security.microsoft.com/api/files/0991a395da64e1c5fbe8732ed11e6be064081d9f/stats?lookBackHours=48

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

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

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
    "sha1": "0991a395da64e1c5fbe8732ed11e6be064081d9f",
    "organizationPrevalence": 14850,
    "orgFirstSeen": "2019-12-07T13:44:16Z",
    "orgLastSeen": "2020-01-06T13:39:36Z",
    "globallyPrevalence": 705012,
    "globalFirstObserved": "2015-03-19T12:20:07.3432441Z",
    "globalLastObserved": "2020-01-06T13:39:36Z",
    "topFileNames": [
        "MREC.exe"
    ]
}