Vanlige Microsoft Defender XDR REST-API-feilkoder

  • Artikkel

Gjelder for:

  • Microsoft Defender XDR

Obs!

Prøv våre nye API-er ved hjelp av MS Graph Security API. Finn ut mer på: Bruk Microsoft Graph security API - Microsoft Graph | Microsoft Learn.

Viktig

Noe informasjon er knyttet til forhåndsutgitt produkt som kan endres vesentlig før det utgis kommersielt. Microsoft gir ingen garantier, uttrykkelige eller underforståtte, med hensyn til informasjonen som er oppgitt her.

Feilkoder kan returneres av en operasjon på hvilken som helst av de Microsoft Defender XDR API-ene. Hvert feilsvar inneholder en feilmelding som kan bidra til å løse problemet. Feilmeldingskolonnen i tabelldelen inneholder noen eksempelmeldinger. Innholdet i faktiske meldinger varierer basert på faktorene som utløste svaret. Variabelt innhold angis med vinkelparenteser (< >) i følgende tabell:

Feilkoder

Feilkode HTTP-statuskode Melding
BadRequest BadRequest (400) Feilmelding om generell ugyldig forespørsel.
ODataError BadRequest (400) Ugyldig OData URI-spørring <den bestemte feilen er angitt>.
InvalidInput BadRequest (400) Ugyldige inndata <for ugyldige inndata>.
InvalidRequestBody BadRequest (400) Ugyldig forespørselstekst.
InvalidHashValue BadRequest (400) Hash-verdien <for den ugyldige hash-koden> er ugyldig.
InvalidDomainName BadRequest (400) Domenenavnet <det ugyldige domenet> er ugyldig.
InvalidIpAddress BadRequest (400) IP-adressen <til den ugyldige IP-adressen> er ugyldig.
InvalidUrl BadRequest (400) URL-adressen <til den ugyldige URL-adressen> er ugyldig.
MaximumBatchSizeExceeded BadRequest (400) Maksimal bunkestørrelse er overskredet. Mottatt: <bunkestørrelse mottatt>, tillatt: {batchstørrelse tillatt}.
MissingRequiredParameter BadRequest (400) Parameteren <mangler den manglende parameteren> .
OsPlatformNotSupported BadRequest (400) OS-plattformen <klient-OS-plattformen> støttes ikke for denne handlingen.
ClientVersionNotSupported BadRequest (400) <Den forespurte handlingen> støttes på klientversjon <støttet klientversjon> og nyere.
Uautorisert Uautorisert (401) Uautorisert

Denne feilen skyldes vanligvis et ugyldig eller utløpt autorisasjonshode.
Forbudt Forbudt (403) Forbudt

Denne feilen kan oppstå med et gyldig token, men utilstrekkelig tillatelse for handlingen.
DisabledFeature Forbudt (403) Leierfunksjon er ikke aktivert.
Ikke tillattOperation Forbudt (403) <den tillatte operasjonen og årsaken>.
NotFound Finner ikke (404) Feilmeldingen Finner ikke generelt.
ResourceNotFound Finner ikke (404) Finner <ikke ressursen den forespurte ressursen> .
InternalServerError Intern serverfeil (500) Hvis det ikke er noen feilmelding, prøver du operasjonen på nytt. Kontakt Microsoft hvis det ikke blir løst.

Eksempler

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

Brødtekstparametere

Viktig

Brødtekstparametere skiller mellom store og små bokstaver.

Hvis du opplever en InvalidRequestBody - eller MissingRequiredParameter-feil , kan den skyldes en skrivefeil. Se gjennom API-dokumentasjonen, og kontroller at de innsendte parameterne samsvarer med det relevante eksemplet.

Sporings-ID

Hvert feilsvar inneholder en unik ID-parameter for sporing. Egenskapsnavnet for denne parameteren er målet. Hvis du kontakter Microsoft om en feil, vil det å legge ved sporings-ID-en hjelpe Microsoft med å finne hovedårsaken til problemet.

Tips

Vil du lære mer? Kommuniser med Microsoft Sikkerhet-fellesskapet i det tekniske fellesskapet vårt: Microsoft Defender XDR Tech Community.