Leggere in inglese

Condividi tramite


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:

Codici di errore

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.

Esempi

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

Parametri del corpo

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.

ID rilevamento

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.

Suggerimento

Per saperne di più, Engage con la community Microsoft Security nella community tech: Microsoft Defender XDR Tech Community.