קבל API של machineAction

חל על:

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

הערה

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

עצה

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

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com

תיאור API

מאחזר פעולת מחשב ספציפית לפי המזהה שלה.

מגבלות

  • דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1500 שיחות בשעה.

הרשאות

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

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

הערה

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

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

בקשת HTTP

GET https://api.securitycenter.microsoft.com/api/machineactions/{id}

כותרות בקשות

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

גוף הבקשה

ריק

תגובה

אם הפעולה הצליחה, שיטה זו מחזירה 200, קוד תגובה של אישור עם ישות פעולת מחשב. אם ישות פעולת מחשב עם המזהה שצוין לא נמצאה - 404 לא נמצא.

דוגמה

בקשה לדוגמה

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

GET https://api.securitycenter.microsoft.com/api/machineactions/2e9da30d-27f6-4208-81f2-9cd3d67893ba

דוגמה לתגובה

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

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
    "id": "5382f7ea-7557-4ab7-9782-d50480024a4e",
    "type": "Isolate",
    "scope": "Selective",
    "requestor": "Analyst@TestPrd.onmicrosoft.com",
    "requestorComment": "test for docs",
    "status": "Succeeded",
    "machineId": "7b1f4967d9728e5aa3c06a9e617a22a4a5a17378",
    "computerDnsName": "desktop-test",
    "creationDateTimeUtc": "2019-01-02T14:39:38.2262283Z",
    "lastUpdateDateTimeUtc": "2019-01-02T14:40:44.6596267Z",
    "relatedFileInfo": null
}