Codici di errore comuni Microsoft Defender XDR API REST
Si applica a:
- Microsoft Defender XDR
Nota
Provare le nuove API usando l'API di sicurezza di MS Graph. Per altre informazioni, vedere: Usare l'API di sicurezza di Microsoft Graph - Microsoft Graph | Microsoft Learn.
Importante
Alcune informazioni fanno riferimento alle caratteristiche del prodotto prima del rilascio, e possono essere modificate sostanzialmente prima della distribuzione al pubblico. Microsoft non fornisce alcuna garanzia, esplicita o implicita, in relazione alle informazioni contenute in questo documento.
I codici di errore possono essere restituiti da un'operazione su qualsiasi API Microsoft Defender XDR. Ogni risposta di errore contiene un messaggio di errore che consente di risolvere il problema. La colonna del messaggio di errore nella sezione della tabella contiene alcuni messaggi di esempio. Il contenuto dei messaggi effettivi varia in base ai fattori che hanno attivato la risposta. Il contenuto delle variabili è indicato dalle parentesi angolari (< >
) nella tabella seguente:
Codice errore | Codice di stato HTTP | Messaggio |
---|---|---|
BadRequest | BadRequest (400) | Messaggio di errore Generale richiesta non valida. |
Odataerror | BadRequest (400) | Query <URI OData non valida specificata per l'errore> specifico. |
InvalidInput | BadRequest (400) | <Input non valido per l'input> non valido. |
InvalidRequestBody | BadRequest (400) | Corpo della richiesta non valido. |
InvalidHashValue | BadRequest (400) | Valore <hash non valido> . |
InvalidDomainName | BadRequest (400) | Nome di <dominio non valido per il dominio> non valido. |
InvalidIpAddress | BadRequest (400) | Indirizzo <IP non valido> . |
InvalidUrl | BadRequest (400) | URL <non valido> . |
MaximumBatchSizeExceeded | BadRequest (400) | La dimensione massima del batch è stata superata. Ricevuto: <dimensioni batch ricevute>, consentite: {dimensioni batch consentite}. |
MissingRequiredParameter | BadRequest (400) | Parametro <mancante> . |
OsPlatformNotSupported | BadRequest (400) | Piattaforma <del sistema operativo la piattaforma> del sistema operativo client non è supportata per questa azione. |
ClientVersionNotSupported | BadRequest (400) | <L'azione> richiesta è supportata nella versione <client supportata dalla versione> client e versioni successive. |
Non autorizzato | Non autorizzato (401) | Non autorizzato Questo errore è in genere causato da un'intestazione di autorizzazione non valida o scaduta. |
Operazione non consentita | Accesso negato (403) | Operazione non consentita Questo errore può verificarsi con un token valido ma autorizzazioni insufficienti per l'azione. |
DisabledFeature | Accesso negato (403) | La funzionalità tenant non è abilitata. |
DisallowedOperation | Accesso negato (403) | <l'operazione non consentita e il motivo>. |
NotFound | Non trovato (404) | Messaggio di errore Generale non trovato. |
ResourceNotFound | Non trovato (404) | Risorsa <che la risorsa> richiesta non è stata trovata. |
InternalServerError | Errore interno del server (500) | Se non è presente alcun messaggio di errore, ritentare l'operazione. Se non viene risolto, contattare Microsoft. |
{
"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"
}
}
Importante
I parametri del corpo fanno distinzione tra maiuscole e minuscole.
Se si verifica un errore InvalidRequestBody o MissingRequiredParameter , potrebbe essere causato da un errore di digitazione. Esaminare la documentazione dell'API e verificare che i parametri inviati corrispondano all'esempio pertinente.
Ogni risposta di errore contiene un parametro ID univoco per il rilevamento. Il nome della proprietà di questo parametro è di destinazione. Se si contatta Microsoft per un errore, il collegamento dell'ID di rilevamento consente a Microsoft di individuare la causa radice del problema.
- Usare l'API di sicurezza di Microsoft Graph - Microsoft Graph | Microsoft Learn
- Panoramica delle API Microsoft Defender XDR
- API di Microsoft Defender XDR supportate
- Accedere alle API Microsoft Defender XDR
- Informazioni sui limiti e sulle licenze delle API
Suggerimento
Per saperne di più, Engage con la community Microsoft Security nella community tech: Microsoft Defender XDR Tech Community.