Yleiset Microsoft Defender XDR REST-ohjelmointirajapinnan virhekoodit
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:
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. |
{
"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"
}
}
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ä.
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.
- Microsoft Graph -suojauksen ohjelmointirajapinnan käyttäminen – Microsoft Graph | Microsoft Learn
- Microsoft Defender XDR ohjelmointirajapintoja yleiskatsaus
- Tuetut Microsoft Defender XDR:n ohjelmointirajapinnat
- Microsoft Defender XDR-ohjelmointirajapinnoille pääsy
- Lisätietoja ohjelmointirajapinnan rajoituksista ja käyttöoikeuksista
Vihje
Haluatko tietää lisää? Ota yhteyttä Microsoft Security -yhteisöön Tech Community -yhteisössä: Microsoft Defender XDR Tech Community.