Jaa

Yleiset Microsoft Defender XDR REST-ohjelmointirajapinnan virhekoodit

  • Artikkeli

Koskee seuraavia:

  • Microsoft Defender XDR

Huomautus

Kokeile uusia ohjelmointirajapintojamme MS Graphin suojauksen ohjelmointirajapinnan avulla. Lisätietoja on osoitteessa: Microsoft Graph -suojauksen ohjelmointirajapinnan käyttäminen - Microsoft Graph | Microsoft Learn.

Tärkeää

Jotkin tiedot liittyvät tuotteen ennakkoon, jota voidaan muuttaa huomattavasti ennen kaupallista julkaisua. Microsoft ei anna nimenomaisia eikä oletettuja takuita tässä annetuista tiedoista.

Mikä tahansa Microsoft Defender XDR-ohjelmointirajapinnoista voi palauttaa virhekoodeja. Jokainen virhevastaus sisältää virhesanoman, joka voi auttaa ratkaisemaan ongelman. Taulukko-osan virhesanomasarake sisältää joitakin esimerkkiviestejä. Todellisten viestien sisältö vaihtelee vastauksen käynnistäneiden tekijöiden mukaan. Vaihteleva sisältö on esitetty kulmasulkeissa (< >) seuraavassa taulukossa:

Virhekoodit

Virhekoodi HTTP-tilakoodi Viesti
Virheellinen vastaus BadRequest (400) Yleinen virheellinen pyyntö -virhesanoma.
ODataError BadRequest (400) Määritetty OData-URI-kysely <ei> kelpaa.
Virheellinen siirtomäärä BadRequest (400) Virheellinen syöte<>.
InvalidRequestBody BadRequest (400) Virheellinen pyynnön teksti.
InvalidHashValue BadRequest (400) Virheellinen> hajautusarvo <on virheellinen.
InvalidDomainName BadRequest (400) Virheellinen toimialueen> nimi <on virheellinen.
InvalidIpAddress BadRequest (400) IP-osoite, jonka IP-osoite <> ei kelpaa, on virheellinen.
Virheellinenurl BadRequest (400) VIRHEELLINEN URL-osoite <> on virheellinen.
MaximumBatchSizeExceeded BadRequest (400) Erän enimmäiskoko on ylitetty. Vastaanotettu: <erän koko vastaanotettu>, sallittu: {erän koko sallittu}.
MissingRequiredParameter BadRequest (400) Puuttuvan parametrin parametri <> puuttuu.
OsPlatformNotSupported BadRequest (400) <Käyttöjärjestelmäsovellusympäristöä> ei tueta tässä toiminnossa.
ClientVersionNotSupported BadRequest (400) <Pyydettyä toimintoa> tuetaan asiakasversion <tukemassa asiakasversiossa> ja uudemmissa versioissa.
Luvaton Luvaton (401) Luvaton

Tämä virhe johtuu yleensä virheellisen tai vanhentuneen valtuutuksen otsikosta.
Kielletty Kielletty (403) Kielletty

Tämä virhe voi ilmetä kelvollisen tunnuksen kanssa, mutta käyttöoikeudet eivät riitä toiminnon käyttöön.
DisabledFeature Kielletty (403) Vuokraajaominaisuus ei ole käytössä.
Ei sallittuOperation Kielletty (403) <ei-sallittu toiminto ja syy>.
Ei ole määritetty Ei löydy (404) Yleistä ei löydy -virhesanoma.
Resurssia ei ole määritetty Ei löydy (404) Resurssia <, jota pyydettyä resurssia> ei löytynyt.
InternalServerError Sisäinen palvelinvirhe (500) Jos virhesanomaa ei ole, yritä suorittaa toiminto uudelleen. Ota yhteyttä Microsoftiin , jos ratkaisu ei ratkea.

Esimerkkejä

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

Leipätekstiparametrit

Tärkeää

Leipätekstiparametrien kirjainkoko on merkitsevä.

Jos kohtaat InvalidRequestBody - tai MissingRequiredParameter-virheen , se saattaa aiheutua kirjoitusvirheestä. Tarkista ohjelmointirajapinnan dokumentaatio ja tarkista, että lähetetyt parametrit vastaavat asiaankuuluvaa esimerkkiä.

Seurantatunnus

Jokainen virhevastaus sisältää yksilöllisen tunnusparametrin seurantaa varten. Tämän parametrin ominaisuuden nimi on target. Jos otat yhteyttä Microsoftiin virheestä, seurantatunnuksen liittäminen auttaa Microsoftia löytämään ongelman perimmäisen syyn.

Vihje

Haluatko tietää lisää? Ota yhteyttä Microsoft Security -yhteisöön Tech Community -yhteisössä: Microsoft Defender XDR Tech Community.