Veelvoorkomende Microsoft Defender XDR REST API-foutcodes

  • Artikel

Van toepassing op:

  • Microsoft Defender XDR

Opmerking

Probeer onze nieuwe API's met behulp van de MS Graph-beveiligings-API. Meer informatie vindt u op: De Microsoft Graph-beveiligings-API gebruiken - Microsoft Graph | Microsoft Learn.

Belangrijk

Sommige informatie is gerelateerd aan voorlopige productversies die mogelijk aanzienlijk gewijzigd worden voordat ze commercieel gepubliceerd worden. Microsoft geeft geen garantie, uitdrukkelijk of impliciet, met betrekking tot de informatie die hier wordt beschreven.

Foutcodes kunnen worden geretourneerd door een bewerking op een van de Microsoft Defender XDR API's. Elk foutantwoord bevat een foutbericht, waarmee het probleem kan worden opgelost. De kolom met foutberichten in de tabelsectie bevat enkele voorbeeldberichten. De inhoud van werkelijke berichten varieert op basis van de factoren die het antwoord hebben geactiveerd. Variabele inhoud wordt aangegeven met haakjes (< >) in de volgende tabel:

Foutcodes

Foutcode HTTP-statuscode Bericht
BadRequest BadRequest (400) Algemeen foutbericht ongeldige aanvraag.
ODataError BadRequest (400) Ongeldige OData-URI-query <de specifieke fout is opgegeven>.
InvalidInput BadRequest (400) Ongeldige invoer <de ongeldige invoer>.
InvalidRequestBody BadRequest (400) Ongeldige aanvraagtekst.
InvalidHashValue BadRequest (400) Hashwaarde <de ongeldige hash> is ongeldig.
InvalidDomainName BadRequest (400) Domeinnaam <het ongeldige domein> is ongeldig.
InvalidIpAddress BadRequest (400) IP-adres het ongeldige IP-adres <> is ongeldig.
InvalidUrl BadRequest (400) URL <de ongeldige URL> is ongeldig.
MaximumBatchSizeExceeded BadRequest (400) De maximale batchgrootte is overschreden. Ontvangen: <batchgrootte ontvangen>, toegestaan: {batchgrootte toegestaan}.
MissingRequiredParameter BadRequest (400) Parameter <de ontbrekende parameter> ontbreekt.
OsPlatformNotSupported BadRequest (400) OS Platform <het client OS Platform> wordt niet ondersteund voor deze actie.
ClientVersionNotSupported BadRequest (400) <De aangevraagde actie> wordt ondersteund op clientversies die worden ondersteund door de clientversie <> en hoger.
Onbevoegde Niet gemachtigd (401) Onbevoegde

Deze fout wordt meestal veroorzaakt door een ongeldige of verlopen autorisatieheader.
Verboden Verboden (403) Verboden

Deze fout kan optreden met een geldig token, maar onvoldoende machtigingen voor de actie.
DisabledFeature Verboden (403) De tenantfunctie is niet ingeschakeld.
DisallowedOperation Verboden (403) <de niet-toegestane bewerking en de reden>.
NotFound Niet gevonden (404) Algemeen foutbericht niet gevonden.
ResourceNotFound Niet gevonden (404) De <aangevraagde resource> is niet gevonden.
InternalServerError Interne serverfout (500) Als er geen foutbericht wordt weergegeven, probeert u de bewerking opnieuw. Neem contact op met Microsoft als dit niet wordt opgelost.

Voorbeelden

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

Hoofdtekstparameters

Belangrijk

Hoofdtekstparameters zijn hoofdlettergevoelig.

Als u een InvalidRequestBody- of MissingRequiredParameter-fout ondervindt, kan dit worden veroorzaakt door een typefout. Bekijk de API-documentatie en controleer of de ingediende parameters overeenkomen met het relevante voorbeeld.

Tracerings-id

Elk foutantwoord bevat een unieke id-parameter voor het bijhouden. De eigenschapsnaam van deze parameter is het doel. Als u contact opneemt met Microsoft over een fout, helpt Microsoft bij het bijvoegen van uw tracerings-id om de hoofdoorzaak van het probleem te vinden.

Tip

Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender XDR Tech Community.