Typowe kody błędów interfejsu API REST Microsoft Defender XDR

  • Artykuł

Dotyczy:

  • Microsoft Defender XDR

Uwaga

Wypróbuj nasze nowe interfejsy API przy użyciu interfejsu API zabezpieczeń programu MS Graph. Dowiedz się więcej na stronie: Korzystanie z interfejsu API zabezpieczeń programu Microsoft Graph — Microsoft Graph | Microsoft Learn.

Ważna

Niektóre informacje odnoszą się do wstępnie wydanego produktu, który może zostać znacząco zmodyfikowany przed jego komercyjną premierą. Firma Microsoft nie udziela żadnych gwarancji, wyraźnych ani dorozumianych, w odniesieniu do podanych tutaj informacji.

Kody błędów mogą być zwracane przez operację na dowolnym interfejsie API Microsoft Defender XDR. Każda odpowiedź na błąd zawiera komunikat o błędzie, który może pomóc w rozwiązaniu problemu. Kolumna komunikatu o błędzie w sekcji tabeli zawiera kilka przykładowych komunikatów. Zawartość rzeczywistych komunikatów różni się w zależności od czynników, które wyzwoliły odpowiedź. Zawartość zmiennej jest wskazywana przez nawiasy kątowe (< >) w poniższej tabeli:

Kody błędów

Kod błędu Kod stanu HTTP Komunikat
BadRequest BadRequest (400) Ogólny komunikat o błędzie Nieprawidłowe żądanie.
ODataError BadRequest (400) Nieprawidłowe zapytanie <OData URI określony błąd jest określony>.
InvalidInput BadRequest (400) Nieprawidłowe dane wejściowe <nieprawidłowych danych wejściowych>.
InvalidRequestBody BadRequest (400) Nieprawidłowa treść żądania.
InvalidHashValue BadRequest (400) Wartość <skrótu nieprawidłowy skrót> jest nieprawidłowy.
InvalidDomainName BadRequest (400) Nazwa <domeny nieprawidłowa domena> jest nieprawidłowa.
InvalidIpAddress BadRequest (400) Nieprawidłowy adres <IP> jest nieprawidłowy.
InvalidUrl BadRequest (400) Adres URL <nieprawidłowego adresu URL> jest nieprawidłowy.
MaximumBatchSizeExceeded BadRequest (400) Przekroczono maksymalny rozmiar partii. Odebrano: <odebrano> rozmiar partii, dozwolone: {dozwolony rozmiar partii}.
MissingRequiredParameter BadRequest (400) Brak <parametru brakującego parametru> .
OsPlatformNotSupported BadRequest (400) Platforma systemu operacyjnego dla <tej akcji nie jest obsługiwana przez platformę> systemu operacyjnego klienta.
ClientVersionNotSupported BadRequest (400) <Żądana akcja> jest obsługiwana w wersji <klienta obsługiwanej wersji> klienta i nowszych.
Nieautoryzowanych Brak autoryzacji (401) Nieautoryzowanych

Ten błąd jest zwykle spowodowany nieprawidłowym lub wygasłym nagłówkiem autoryzacji.
Dostęp zabroniony Zabronione (403) Dostęp zabroniony

Ten błąd może wystąpić z prawidłowym tokenem, ale niewystarczającym uprawnieniem do akcji.
DisabledFeature Zabronione (403) Funkcja dzierżawy nie jest włączona.
NiedozwoloneOperacja Zabronione (403) <niedozwolonej operacji i przyczyny>.
Notfound Nie znaleziono (404) Ogólny komunikat o błędzie Nie znaleziono.
ResourceNotFound Nie znaleziono (404) Zasób <nie został odnaleziony przez żądany zasób> .
InternalServerError Wewnętrzny błąd serwera (500) Jeśli nie ma komunikatu o błędzie, spróbuj ponownie wykonać operację. Jeśli problem nie zostanie rozwiązany, skontaktuj się z firmą Microsoft.

Przykłady

{
    "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"
    }
}

Parametry treści

Ważna

Parametry treści uwzględniają wielkość liter.

Jeśli wystąpi błąd InvalidRequestBody lub MissingRequiredParameter , może to być spowodowane literówką. Przejrzyj dokumentację interfejsu API i sprawdź, czy przesłane parametry są zgodne z odpowiednim przykładem.

Identyfikator śledzenia

Każda odpowiedź błędu zawiera unikatowy parametr identyfikatora do śledzenia. Nazwa właściwości tego parametru jest docelowa. Jeśli skontaktujesz się z firmą Microsoft w sprawie błędu, dołączenie identyfikatora śledzenia pomoże firmie Microsoft znaleźć główną przyczynę problemu.

Porada

Chcesz dowiedzieć się więcej? Zaangażuj się w społeczność rozwiązań zabezpieczających firmy Microsoft w naszej społeczności technicznej Społeczność techniczna usługi Microsoft Defender XDR.