קבל API של סטטיסטיקות IP

חל על:

• Microsoft Defender עבור תוכנית 1 של נקודת קצה
• Microsoft Defender עבור תוכנית 2 של נקודת קצה
• Microsoft Defender XDR

רוצה לחוות את 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

תיאור API

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

מגבלות

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

הרשאות

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

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

הערה

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

• המשתמש צריך להיות בעל הרשאת התפקיד הבאה לפחות: 'הצגת נתונים' (לקבלת מידע נוסף, ראה Create ולנהל תפקידים)

בקשת HTTP

GET /api/ips/{ip}/stats

כותרות בקשות

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

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

Name	סוג	תיאור
שעות חיפוש	Int32	מגדיר את השעות שאנו חפשו חזרה כדי לקבל את הסטטיסטיקה. ברירות מחדל ל- 30 יום. אופציונלי .

גוף הבקשה

ריק

תגובה

אם ה-ip מוצלח וקיימים - 200 אישור עם נתונים סטטיסטיים בגוף. IP חוקי אך אינו קיים - organizationPrevalence 0, IP אינו חוקי - HTTP 400.

דוגמה

דוגמה לבקשה

להלן דוגמה לבקשה.

GET https://api.security.microsoft.com/api/ips/10.209.67.177/stats?lookBackHours=48

דוגמה לתגובה

להלן דוגמה לתגובה.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgIPStats",
    "ipAddress": "10.209.67.177",
    "organizationPrevalence": 63515,
    "orgFirstSeen": "2017-07-30T13:36:06Z",
    "orgLastSeen": "2017-08-29T13:32:59Z"
}

Name	תיאור
שכיחות הארגון	הספירה הייחודית של מכשירים שפתחת את חיבור הרשת ל- IP זה.
הארגון נראה לראשונה	החיבור הראשון עבור IP זה בארגון.
הארגון נראה לאחרונה	החיבור האחרון עבור IP זה בארגון.

הערה

מידע סטטיסטי זה מבוסס על נתונים מ- 30 הימים האחרונים.

עצה

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