Veelvoorkomende Microsoft Defender XDR REST API-foutcodes
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.
Verwante artikelen
- De Microsoft Graph-beveiligings-API gebruiken - Microsoft Graph | Microsoft Learn
- Overzicht van Microsoft Defender XDR API's
- Ondersteunde Microsoft Defender XDR-API's
- Toegang tot de Microsoft Defender XDR API's
- Meer informatie over API-limieten en -licenties
Tip
Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender XDR Tech Community.