שתף באמצעות

קודי שגיאה 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 למצוא את סיבת הבסיס לבעיה.

עצה

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