הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
תיאור API
מאחזר פעולת מחשב ספציפית לפי המזהה שלה.
מגבלות
- דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1500 שיחות בשעה.
הרשאות
בעת השגת אסימון באמצעות אישורי משתמש:
- המשתמש צריך להיות בעל הרשאת התפקיד הבאה לפחות: 'הצג נתונים'. לקבלת מידע נוסף, ראה: יצירה וניהול של תפקידים.
אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש ב - Defender for Endpoint API.
| סוג הרשאה | הרשאה | שם תצוגה של הרשאה |
|---|---|---|
| יישום | Machine.ReadWrite.All | 'קרא וכתוב את כל פרטי המכונה' |
| מוסמך (חשבון בעבודה או בבית ספר) | Machine.ReadWrite | 'קרא וכתוב מידע מחשב' |
בקשת HTTP
GET https://api.security.microsoft.com/api/machineactions/{id}
כותרות בקשות
| Name | סוג | תיאור |
|---|---|---|
| ההרשאות | מחרוזת | נושא {token}. נדרש . |
גוף הבקשה
ריק
תגובה
אם הפעולה הצליחה, שיטה זו מחזירה 200, קוד תגובה של אישור עם ישות פעולת מחשב. אם ישות פעולת מחשב עם המזהה שצוין לא נמצאה - 404 לא נמצא.
דוגמה
בקשה לדוגמה
להלן דוגמה לבקשה.
GET https://api.security.microsoft.com/api/machineactions/aaaabbbb-0000-cccc-1111-dddd2222eeee
דוגמה לתגובה
להלן דוגמה לתגובה.
HTTP/1.1 200 Ok
Content-type: application/json
{
"@odata.context": "https://api.security.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
}