Sdílet prostřednictvím

Běžné kódy chyb rozhraní REST API Microsoft Defender XDR

  • Článek

Platí pro:

  • Microsoft Defender XDR

Poznámka

Vyzkoušejte naše nová rozhraní API s využitím rozhraní MS Graph Security API. Další informace najdete v tématu : Použití rozhraní Microsoft Graph Security API – Microsoft Graph | Microsoft Learn.

Důležité

Některé informace se týkají předprodeje produktu, který může být před komerčním vydáním podstatně změněn. Společnost Microsoft neposkytuje v souvislosti se zde uvedenými informacemi žádné výslovné ani předpokládané záruky.

Kódy chyb může vrátit operace na libovolném Microsoft Defender XDR ROZHRANÍ API. Každá chybová odpověď obsahuje chybovou zprávu, která může pomoct problém vyřešit. Sloupec s chybovou zprávou v oddílu tabulky obsahuje několik ukázkových zpráv. Obsah skutečných zpráv se liší v závislosti na faktorech, které aktivovaly odpověď. Obsah proměnné je označen úhlové závorky (< >) v následující tabulce:

Kódy chyb

Kód chyby Stavový kód HTTP Zpráva
BadRequest BadRequest (400) Obecná chybová zpráva Chybný požadavek
Chyba OData BadRequest (400) Neplatný dotaz <URI OData: Je zadána> konkrétní chyba.
InvalidInput BadRequest (400) Neplatný vstup<: Neplatný vstup>
InvalidRequestBody BadRequest (400) Neplatný text požadavku.
InvalidHashValue BadRequest (400) Hodnota <hash: Neplatná hodnota hash> je neplatná.
InvalidDomainName BadRequest (400) Název <domény: Neplatná doména> je neplatná.
InvalidIpAddress BadRequest (400) IP adresa: Neplatná IP> adresa <je neplatná.
Neplatná adresa BadRequest (400) Adresa URL <: Neplatná adresa URL> je neplatná.
MaximumBatchSizeExceeded BadRequest (400) Byla překročena maximální velikost dávky. Přijato: <přijatá> velikost dávky, povolená: {povolená velikost dávky}.
MissingRequiredParameter BadRequest (400) Chybějící parametr <> chybí.
OsPlatformNotSupported BadRequest (400) Platforma <operačního systému Klientská platforma> operačního systému se pro tuto akci nepodporuje.
ClientVersionNotSupported BadRequest (400) <Požadovaná akce> je podporována v podporované verzi <klienta a novější verzi> klienta.
Neoprávněným Neautorizováno (401) Neoprávněným

Příčinou této chyby je obvykle neplatná autorizační hlavička nebo hlavička autorizace, která vypršela.
Zakázáno Zakázáno (403) Zakázáno

K této chybě může dojít s platným tokenem, ale nedostatečným oprávněním k akci.
DisabledFeature Zakázáno (403) Funkce tenanta není povolená.
NepovolenoOperace Zakázáno (403) <nepovolenou operaci a důvod>.
Nenalezeno Nenalezena (404) Obecná chybová zpráva Nenalezena.
ResourceNotFound Nenalezena (404) Prostředek <požadovaný prostředek> se nenašel.
InternalServerError Vnitřní chyba serveru (500) Pokud se nezobrazí žádná chybová zpráva, zkuste operaci zopakovat. Pokud se problém nevyřeší, obraťte se na Microsoft.

Příklady

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

Důležité

V parametrech textu se rozlišují malá a velká písmena.

Pokud dojde k chybě InvalidRequestBody nebo MissingRequiredParameter , může to být způsobeno překlepem. Projděte si dokumentaci k rozhraní API a zkontrolujte, jestli odeslané parametry odpovídají příslušnému příkladu.

ID sledování

Každá odpověď na chybu obsahuje jedinečný parametr ID pro sledování. Název vlastnosti tohoto parametru je target. Pokud se obrátíte na Microsoft kvůli chybě, připojení id sledování pomůže microsoftu najít původní příčinu problému.

Tip

Chcete se dozvědět více? Spojte se s komunitou zabezpečení společnosti Microsoft v naší technické komunitě: Technická komunita Microsoft Defender XDR.