Codici di errore API REST comuniCommon REST API error codes

  • I codici di errore elencati nella tabella seguente possono essere restituiti da un'operazione su qualsiasi API di Microsoft Defender for Endpoint.The error codes listed in the following table may be returned by an operation on any of Microsoft Defender for Endpoint APIs.
  • Oltre al codice di errore, ogni risposta di errore contiene un messaggio di errore che consente di risolvere il problema.In addition to the error code, every error response contains an error message, which can help resolve the problem.
  • Il messaggio è un testo libero che può essere modificato.The message is a free text that can be changed.
  • Nella parte inferiore della pagina sono disponibili esempi di risposta.At the bottom of the page, you can find response examples.

Vuoi provare Defender per Endpoint?Want to experience Defender for Endpoint? Iscriversi per una versione di valutazione gratuita.Sign up for a free trial.

Codice di erroreError code Codice di stato HTTPHTTP status code MessaggioMessage
BadRequestBadRequest BadRequest (400)BadRequest (400) Messaggio di errore Generale richiesta non valida.General Bad Request error message.
ODataErrorODataError BadRequest (400)BadRequest (400) Query URI OData non valida (viene specificato l'errore specifico).Invalid OData URI query (the specific error is specified).
InvalidInputInvalidInput BadRequest (400)BadRequest (400) Input non valido {input non valido}.Invalid input {the invalid input}.
InvalidRequestBodyInvalidRequestBody BadRequest (400)BadRequest (400) Corpo della richiesta non valido.Invalid request body.
InvalidHashValueInvalidHashValue BadRequest (400)BadRequest (400) Valore hash {hash non valido} non valido.Hash value {the invalid hash} is invalid.
InvalidDomainNameInvalidDomainName BadRequest (400)BadRequest (400) Nome di dominio {dominio non valido} non valido.Domain name {the invalid domain} is invalid.
InvalidIpAddressInvalidIpAddress BadRequest (400)BadRequest (400) L'indirizzo IP {l'IP non valido} non è valido.IP address {the invalid IP} is invalid.
InvalidUrlInvalidUrl BadRequest (400)BadRequest (400) L'URL {l'URL non valido} non è valido.URL {the invalid URL} is invalid.
MaximumBatchSizeExceededMaximumBatchSizeExceeded BadRequest (400)BadRequest (400) Dimensione massima batch superata.Maximum batch size exceeded. Received: {batch size received}, allowed: {batch size allowed}.Received: {batch size received}, allowed: {batch size allowed}.
MissingRequiredParameterMissingRequiredParameter BadRequest (400)BadRequest (400) Parametro {parametro mancante} mancante.Parameter {the missing parameter} is missing.
OsPlatformNotSupportedOsPlatformNotSupported BadRequest (400)BadRequest (400) Piattaforma del sistema operativo {piattaforma del sistema operativo client} non supportata per questa azione.OS Platform {the client OS Platform} is not supported for this action.
ClientVersionNotSupportedClientVersionNotSupported BadRequest (400)BadRequest (400) {L'azione richiesta} è supportata nella versione client {versione client supportata} e versioni successive.{The requested action} is supported on client version {supported client version} and above.
Non autorizzatoUnauthorized Non autorizzato (401)Unauthorized (401) Non autorizzato (intestazione di autorizzazione non valida o scaduta).Unauthorized (invalid or expired authorization header).
Accesso negatoForbidden Accesso negato (403)Forbidden (403) Accesso negato (token valido ma autorizzazione insufficiente per l'azione).Forbidden (valid token but insufficient permission for the action).
DisabledFeatureDisabledFeature Accesso negato (403)Forbidden (403) La funzionalità tenant non è abilitata.Tenant feature is not enabled.
DisallowedOperationDisallowedOperation Accesso negato (403)Forbidden (403) {l'operazione non consentita e il motivo}.{the disallowed operation and the reason}.
NotFoundNotFound Non trovato (404)Not Found (404) Messaggio di errore Generale non trovato.General Not Found error message.
ResourceNotFoundResourceNotFound Non trovato (404)Not Found (404) Impossibile trovare la risorsa {la risorsa richiesta}.Resource {the requested resource} was not found.
InternalServerErrorInternalServerError Errore interno del server (500)Internal Server Error (500) (Nessun messaggio di errore, ritentare l'operazione)(No error message, retry the operation)
TooManyRequestsTooManyRequests Troppe richieste (429)Too Many Requests (429) La risposta rappresenterà il raggiungimento del limite di quota in base al numero di richieste o alla CPU.Response will represent reaching quota limit either by number of requests or by CPU.

Per i parametri corpo viene distinzione tra maiuscole e minuscoleBody parameters are case-sensitive

Per i parametri del corpo inviato viene attualmente fatto distinzione tra maiuscole e minuscole.The submitted body parameters are currently case-sensitive.
Se si verifica un errore InvalidRequestBody o MissingRequiredParameter, potrebbe essere causato da un parametro errato maiuscolo o minuscolo.If you experience an InvalidRequestBody or MissingRequiredParameter errors, it might be caused from a wrong parameter capital or lower-case letter.
Esaminare la pagina della documentazione dell'API e verificare che i parametri inviati corrispondano all'esempio pertinente.Review the API documentation page and check that the submitted parameters match the relevant example.

ID richiesta di correlazioneCorrelation request ID

Ogni risposta di errore contiene un parametro ID univoco per il rilevamento.Each error response contains a unique ID parameter for tracking.
Il nome della proprietà di questo parametro è "target".The property name of this parameter is "target".
Quando ci viene contattato per un errore, l'associazione di questo ID consente di individuare la causa radice del problema.When contacting us about an error, attaching this ID will help find the root cause of the problem.

EsempiExamples

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