קודי שגיאה Microsoft Defender XDR REST API נפוצים
חל על:
- Microsoft Defender XDR
הערה
נסה את ממשקי ה- API החדשים שלנו באמצעות API של אבטחה של MS Graph. קבל מידע נוסף ב: השתמש ב- API לאבטחה של Microsoft Graph - Microsoft Graph | Microsoft Learn.
חשוב
חלק מהמידע מתייחס למוצר שהופץ מראש, אשר עשוי להיות שונה באופן משמעותי לפני ההפצה המסחרית שלו. Microsoft אינה מבטיחה דבר, באופן מפורש או משתמע, באשר למידע המסופק כאן.
ניתן להחזיר קודי שגיאה על-ידי פעולה בכל אחד Microsoft Defender XDR API. כל תגובה לשגיאה מכילה הודעת שגיאה, שיכולה לעזור לך לפתור את הבעיה. עמודת הודעת השגיאה במקטע הטבלה מספקת כמה הודעות לדוגמה. התוכן של ההודעות עצמן משתנה בהתאם לגורמים שהפעילו את התגובה. תוכן משתנה מצוין על-ידי סוגריים זוויתיים (< >
) בטבלה הבאה:
קוד שגיאה | קוד מצב HTTP | ההודעה |
---|---|---|
בקשה ל- BadRequest | הורדות ב- BadRequest (400) | הודעת שגיאה כללית של בקשה שגויה. |
ODataError | הורדות ב- BadRequest (400) | צוינה שאילתת URI לא חוקית של <OData השגיאה הספציפית>. |
תפוקה לא חוקית | הורדות ב- BadRequest (400) | קלט לא חוקי <קלט לא חוקי>. |
InvalidRequestBody | הורדות ב- BadRequest (400) | גוף בקשה לא חוקי. |
InvalidHashValue | הורדות ב- BadRequest (400) | ערך ה- <Hash של קוד ה- Hash> הלא חוקי אינו חוקי. |
InvalidDomainName | הורדות ב- BadRequest (400) | שם התחום שהתחום <הלא חוקי> אינו חוקי. |
InvalidIpAddress | הורדות ב- BadRequest (400) | כתובת ה- <IP שה- IP הלא> חוקי אינו חוקי. |
ערך לא חוקי | הורדות ב- BadRequest (400) | כתובת ה- URL <חוקית של כתובת ה- URL> אינה חוקית. |
MaximumBatchSizeExceeded | הורדות ב- BadRequest (400) | אירעה חריגה מגודל האצווה המרבי. התקבל: גודל <אצווה התקבל>, מותר: {batch size allowed}. |
MissingRequiredParameter | הורדות ב- BadRequest (400) | הפרמטר <חסר בפרמטר> חסר. |
OsPlatformNotSupported | הורדות ב- BadRequest (400) | פלטפורמת מערכת <ההפעלה פלטפורמת מערכת ההפעלה> של הלקוח אינה נתמכת עבור פעולה זו. |
ClientVersionNotSupported | הורדות ב- BadRequest (400) | <הפעולה המבוקשת> נתמכת בגירסאות הלקוח הנתמכות <של גירסת הלקוח> ואילך. |
מורשית | לא מורשה (401) | מורשית שגיאה זו נגרמת בדרך כלל על-ידי כותרת הרשאה לא חוקית או שפג תוקפה. |
אסור | אסור (403) | אסור שגיאה זו עשויה להתרחש עם אסימון חוקי אך הרשאה לא מספיקה עבור הפעולה. |
הזנה לא זמינה | אסור (403) | תכונת הדייר אינה זמינה. |
פעולה אסורה | אסור (403) | <הפעולה המוסחרת והסיבה>. |
NotFound | לא נמצא (404) | הודעת שגיאה כללית לא נמצאה. |
ResourceNotFound | לא נמצא (404) | המשאב <המבוקש> לא נמצא. |
InternalServerErError | שגיאת שרת פנימית (500) | אם אין הודעת שגיאה, נסה שוב לבצע את הפעולה. צור קשר עם Microsoft אם היא אינה נפתרת. |
{
"error": {
"code": "ResourceNotFound",
"message": "Machine 123123123 was not found",
"target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
}
}
{
"error": {
"code": "InvalidRequestBody",
"message": "Request body is incorrect",
"target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
}
}
חשוב
הפרמטרים של הגוף הם תלויי רישיות.
אם אתה נתקל בשגיאה InvalidRequestBody אוMissingRequiredParameter , ייתכן שהסיבה לכך היא שגיאת הקלדה. עיין בתיעוד ה- API ובדוק שהפרמטרים שנשלחו תואמים לדוגמה הרלוונטית.
כל תגובה לשגיאה מכילה פרמטר מזהה ייחודי למעקב. שם המאפיין של פרמטר זה הוא יעד. אם אתה מתחבר ל- Microsoft בנוגע לשגיאה, צירוף מזהה המעקב שלך עוזר ל- Microsoft למצוא את סיבת הבסיס לבעיה.
- השתמש ב- API של אבטחת Microsoft Graph - Microsoft Graph | Microsoft Learn
- Microsoft Defender XDR כולל על ממשקי API
- ממשקי API נתמכים של Microsoft Defender XDR
- גישה Microsoft Defender XDR API
- קבל מידע על מגבלות API ורישוי
טיפ
האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילת הטכנולוגיה שלנו: קהילת האבטחה של Microsoft Defender XDR.