Typowe kody błędów interfejsu API REST Microsoft Defender XDR
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żne
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:
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. |
{
"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"
}
}
Ważne
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.
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.
- Korzystanie z interfejsu API zabezpieczeń programu Microsoft Graph — Microsoft Graph | Microsoft Learn
- Omówienie interfejsów API Microsoft Defender XDR
- Obsługiwane interfejsy API usługi Microsoft Defender XDR
- Uzyskiwanie dostępu do interfejsów API Microsoft Defender XDR
- Dowiedz się więcej o limitach interfejsu API i licencjonowaniu
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.