שתף באמצעות

קבל API של סטטיסטיקות קבצים

  • מאמר

חל על:

רוצה להתנסות ב- Microsoft Defender עבור נקודת קצה? הירשם לקבלת גירסת ניסיון ללא תשלום.

הערה

אם אתה לקוח של ממשלת ארה"ב, השתמש בURI המפורטים ב - Microsoft Defender for Endpoint עבור לקוחות של ממשלת ארה"ב.

עצה

לקבלת ביצועים טובים יותר, באפשרותך להשתמש בשרת קרוב יותר למיקום הגיאוגרפי שלך:

  • 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

תיאור API

מאחזר את הסטטיסטיקה עבור הקובץ הנתון.

מגבלות

  1. דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1500 שיחות בשעה.
  2. הערך המרבי עבור הוא lookbackhours 720 שעות(30 ימים).

הרשאות

אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש ב- Microsoft Defender עבור ממשקי API של נקודת קצה

סוג הרשאה הרשאה שם תצוגה של הרשאה
יישום File.Read.All 'קריאת פרופילי קבצים'
מוסמך (חשבון בעבודה או בבית ספר) File.Read.All 'קריאת פרופילי קבצים'

הערה

בעת השגת אסימון באמצעות אישורי משתמש:

בקשת HTTP

GET /api/files/{id}/stats

כותרות בקשות

Name סוג תיאור
ההרשאות מחרוזת נושא {token}. נדרש .

בקש פרמטרים של URI

Name סוג תיאור
שעות חיפוש 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"
    ]
}

עצה

האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילה הטכנית שלנו: Microsoft Defender for Endpoint Tech Community.