Vanlige Microsoft Defender XDR REST-API-feilkoder
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:
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. |
{
"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"
}
}
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.
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.
- Bruk Microsoft Graph-sikkerhets-API -en – Microsoft Graph | Microsoft Learn
- oversikt over Microsoft Defender XDR API-er
- Støttede Microsoft Defender XDR API-er
- Få tilgang til de Microsoft Defender XDR API-ene
- Finn ut mer om API-grenser og lisensiering
Tips
Vil du lære mer? Kommuniser med Microsoft Sikkerhet-fellesskapet i det tekniske fellesskapet vårt: Microsoft Defender XDR Tech Community.