Errori API
Errori comuni restituiti da tutti i servizi
La tabella seguente elenca gli errori comuni restituiti da tutti i servizi per Oracle Cloud Infrastructure.
| Codice stato HTTP | Codice di errore | Descrizione | Riprovare |
|---|---|---|---|
| 400 | CannotParseRequest |
La richiesta è formattata in modo errato. | No |
| 400 | InvalidParameter
|
Un parametro non è valido o è formattato in modo errato. | No |
| 400 | LimitExceeded
|
L'evasione di questa richiesta supera il limite definito da Oracle per questa tenancy per questo tipo di risorsa. | No |
| 400 | MissingParameter
|
Parametro richiesto mancante. | No |
| 400 | QuotaExceeded
|
L'evasione di questa richiesta supera la quota definita dall'amministratore per questo compartimento per questa risorsa. | No |
| 400 | RelatedResourceNot AuthorizedOrNotFound
|
Una risorsa specificata nel corpo della richiesta non è stata trovata oppure non si dispone dell'autorizzazione per accedere a tale risorsa. |
No |
| 401 | NotAuthenticated
|
Le informazioni di autenticazione richieste non sono state fornite o sono errate. |
No |
| 403 | NotAllowed
|
Questa operazione deve essere diretta all'area di origine. | No |
| 403 | NotAuthorized
|
Non si dispone dell'autorizzazione per aggiornare uno o più campi inclusi in questa richiesta. | No |
| 403 | SignUpRequired
|
Questa operazione richiede l'opt-in prima di poter essere richiamata. | No |
| 404 | InvalidParameter |
Un componente del percorso dinamico non è valido o è sintatticamente valido, ma non è consentito. | No |
| 404 | NotAuthorizedOrNotFound
|
Una risorsa specificata tramite l'URI (percorso o parametri di query) della richiesta non è stata trovata oppure non si dispone dell'autorizzazione per accedere a tale risorsa. Per ulteriori informazioni, vedere Codice stato HTML 404. | No |
| 404 | NotFound
|
Nessuna operazione supportata nel percorso URI e nel metodo HTTP specificati nella richiesta. | No |
| 404 | NamespaceNotFound
|
Non si dispone dell'autorizzazione per eseguire questa richiesta o la risorsa richiesta non è stata trovata. | No |
| 405 | MethodNotAllowed
|
La risorsa di destinazione non supporta il metodo HTTP. | No |
| 409 | Conflict
|
Lo stato richiesto per la risorsa è in conflitto con lo stato corrente. Questo stato non è transitorio. | No |
| 409 | ExternalServerIncorrectState
|
Il server si trova in uno stato errato e si è verificato il timeout, ha restituito una risposta non valida o non è raggiungibile. | Sì, con backoff. Fare riferimento alla descrizione dell'errore per qualsiasi azione richiesta prima di riprovare. |
| 409 | IncorrectState
|
Lo stato richiesto per la risorsa è in conflitto con lo stato corrente, ma è stato specificato un periodo di tempo che sarà nello stato corretto. | Sì, con backoff. Fare riferimento alla descrizione dell'errore per qualsiasi azione richiesta prima di riprovare. |
| 409 | InvalidatedRetryToken
|
Il token di nuovo tentativo fornito è stato utilizzato in una richiesta precedente che ha provocato un aggiornamento del sistema, ma un'operazione successiva ha invalidato il token. Ciò può verificarsi, ad esempio, nei casi in cui un'entità creata con lo stesso token è stata successivamente eliminata. Se la modifica dello stato del sistema associata a questa richiesta deve essere eseguita di nuovo, riprovare utilizzando un token diverso. | No |
| 409 | ResourceLocked
|
La risorsa richiesta è bloccata. Questo in genere è dovuto al fatto che la risorsa è in uso attivo oppure perché la modifica della risorsa comporta l'interruzione del funzionamento di un'altra risorsa. | No |
| 409 | NotAuthorizedOrResourceAlreadyExists
|
Non si dispone dell'autorizzazione per eseguire questa richiesta oppure la risorsa che si sta tentando di creare esiste già. Questo codice di errore viene restituito solo dalle operazioni create, dove viene restituito invece del codice di errore NotAuthorizedOrNotFound più generale. |
No |
| 412 | NoEtagMatch
|
Il valore ETag specificato nella richiesta non corrisponde al valore ETag per la risorsa. | No |
| 413 | PayloadTooLarge
|
L'entità richiesta è maggiore dei limiti definiti dal server. | No |
| 422 | UnprocessableEntity
|
Il payload è corretto a livello sintattico, ma non è valido a livello semantico. | No |
| 429 | TooManyRequests
|
Hai inviato troppe richieste alle API di Oracle Cloud Infrastructure in un periodo di tempo troppo breve. | Sì, con backoff. |
| 431 | RequestHeaderFieldsTooLarge
|
Le intestazioni HTTP della richiesta sono troppo lunghe. La richiesta può essere risottomessa dopo aver ridotto le dimensioni delle intestazioni della richiesta. | No |
| 500 | InternalServerError
|
Si è verificato un errore interno del server. | Sì, con backoff. |
| 501 | MethodNotImplemented
|
La destinazione della richiesta HTTP non riconosce il metodo HTTP. | No |
| 503 | ExternalServerUnreachable
|
Impossibile stabilire una connessione con un sistema esterno necessario per soddisfare la richiesta. | Sì, con backoff. |
| 503 | ExternalServerTimeout
|
Timeout di una connessione con un sistema esterno necessario per soddisfare la richiesta prima della ricezione di una risposta. | Sì, con backoff. |
| 503 | ExternalServerInvalidResponse
|
Una connessione con un sistema esterno necessario per soddisfare la richiesta ha determinato una risposta inaccettabile. | Sì, con backoff. |
| 503 | ServiceUnavailable
|
Al momento il servizio non è disponibile. | Sì, con backoff. |
Dettagli errore API e risoluzione dei problemi
Questa sezione contiene informazioni dettagliate e suggerimenti per la risoluzione dei problemi relativi ai codici di errore dello stato HTTP.
Codici errore stato HTTP 400
InvalidParameter
Descrizione
Un valore di parametro non è valido o è formattato in modo errato.
Risoluzione dei problemi
- Per informazioni sull'operazione, fare riferimento alla documentazione dell'API REST e controllare i parametri nella richiesta di errori di battitura o formati errati e correggere la richiesta.
MissingParameter
Descrizione
Parametro richiesto mancante
Risoluzione dei problemi
- Nella richiesta manca un parametro obbligatorio per l'API. Per informazioni sull'operazione e correggere la richiesta, consultare la documentazione relativa all'API REST.
QuotaExceeded
Descrizione
L'evasione di questa richiesta supera la quota definita dall'amministratore per questo compartimento per questa risorsa.
Risoluzione dei problemi
- La quota definita dall'amministratore per questo compartimento per questa risorsa verrà superata evadendo questa richiesta. Controllare la quota di risorse e richiedere un aumento per la quota oppure eseguire il cleanup delle risorse inutilizzate, se necessario. Per ulteriori informazioni sulle quote, vedere: Panoramica sulle quote del compartimento.
LimitExceeded
Descrizione
L'evasione di questa richiesta supera il limite definito da Oracle per questa tenancy per questo tipo di risorsa.
Risoluzione dei problemi
Il limite definito da Oracle per questa tenancy per questo tipo di risorsa verrà superato soddisfacendo questa richiesta. Controllare il limite del livello di tenancy per questa risorsa e richiedere un aumento del limite nella tenancy oppure eseguire il cleanup delle risorse inutilizzate e inviare di nuovo la richiesta. Per comprendere meglio i limiti del servizio OCI e come richiedere un aumento del limite, vedere Limiti del servizio.CannotParseRequest
Descrizione
La richiesta è formattata in modo errato.
Risoluzione dei problemi
La richiesta per la maggior parte delle operazioni che acquisiscono un corpo deve essere formattata come JSON. Consulta la documentazione dell'API REST per verificare se l'operazione richiede JSON e, in caso affermativo, confermare che si sta passando un JSON valido nel corpo della richiesta.InvalidStorageTier
Descrizione
La richiesta utilizza un livello di storage non valido.
Risoluzione dei problemi
Il parametro storageTier fornito non è corretto. Per informazioni sull'operazione e correggere la richiesta, consultare la documentazione relativa all'API REST.Codici errore stato HTTP 401
NotAuthenticated
Descrizione
Le informazioni di autenticazione richieste non sono state fornite o sono errate.
Risoluzione dei problemi
Ci sono diverse cose che possono attivare questo codice di errore:
- Informazioni di autenticazione mancanti o errate.
- Verificare che tutte le informazioni richieste (OCID tenant, OCID utente, impronta digitale e chiave privata) siano fornite e accurate
- Verificare che
private_key_pathpunti alla chiave privata e non alla chiave pubblica corrispondente - Verificare che il formato delle coppie di chiavi pubbliche/private in uso sia corretto
- Verificare che l'account utente faccia parte di un gruppo con le autorizzazioni appropriate per eseguire le azioni nel piano in esecuzione
- Verificare che la tenancy sia stata sottoscritta all'area di destinazione nel piano
- Verificare che la chiave pubblica corrispondente all'impronta digitale sia stata caricata per l'utente su cui si sta effettuando la richiesta. Per ulteriori informazioni, vedere Chiavi e OCID obbligatori.
- Disallineamento clock. Questo codice di stato viene restituito se l'orologio del client è distorto più di cinque (5) minuti dall'orologio del server. Per ulteriori informazioni, vedere Skew clock client consentito massimo.
- Errore di firma della richiesta API. Questo codice di stato viene restituito se un'informazione richiesta risulta mancante o non valida nell'intestazione di autorizzazione. Per ulteriori informazioni, vedere Richiedi firme.
Codici errore stato HTTP 403
SignUpRequired
Descrizione
Questa operazione richiede l'inclusione prima di poter essere richiamata.
Risoluzione dei problemi
Assicurarsi che l'utente sia iscritto a questa funzione. In caso contrario, contattare l'assistenza e iscriversi a questo servizio.NotAllowed
Descrizione
Questa operazione deve essere diretta all'area di origine.
Risoluzione dei problemi
Questa operazione deve essere diretta all'area di origine. Aggiornare il codice di origine per fornire le informazioni corrette sull'area.NotAuthorized
Descrizione
Non si dispone dell'autorizzazione per aggiornare uno o più campi inclusi in questa richiesta.
Risoluzione dei problemi
Controllare la richiesta e rimuovere eventuali campi non autorizzati. Per ulteriori informazioni sulle autorizzazioni, vedere Riferimento criteri.Codici errore stato HTTP 404
NamespaceNotFound
Descrizione
Una risorsa specificata tramite l'URI (percorso o parametri di query) della richiesta non è stata trovata oppure non si dispone dell'autorizzazione per accedere a tale risorsa.
Risoluzione dei problemi
La risorsa non è stata trovata o il chiamante non è autorizzato a eseguire l'operazione richiesta sulla risorsa, per una risorsa specificata tramite l'URI di richiesta per le operazioni GET (list or single entity GET), UPDATE e DELETE. Verificare che la risorsa richiesta esista effettivamente e che si disponga dell'accesso. Per ulteriori informazioni sulle autorizzazioni, vedere Riferimento criteri.NotFound
Descrizione
Nessuna operazione supportata nel percorso URI e nel metodo HTTP specificati nella richiesta.
Risoluzione dei problemi
I componenti del percorso statico non esistono o non si è autorizzati ad accedervi. Controllare la richiesta e aggiornare il componente del percorso statico.NotAuthorizedOrNotFound
Descrizione
Una risorsa specificata tramite l'URI (percorso o parametri di query) della richiesta non è stata trovata oppure non si dispone dell'autorizzazione per accedere a tale risorsa.
Risoluzione dei problemi
La risorsa non è stata trovata o il chiamante non è autorizzato a eseguire l'operazione richiesta sulla risorsa, per una risorsa specificata tramite l'URI di richiesta per le operazioni GET (list or single entity GET), UPDATE e DELETE. Verificare che la risorsa richiesta esista effettivamente e che si disponga dell'accesso. Per ulteriori informazioni sulle autorizzazioni, vedere Riferimento criteri.InvalidParameter
Descrizione
Un parametro specificato nel percorso non è valido o è sintatticamente valido ma non è consentito.
Risoluzione dei problemi
Controllare i parametri nella richiesta per errori di battitura o formati errati. Per informazioni sull'operazione e correggere la richiesta, consultare la documentazione relativa all'API REST.Codici errore stato HTTP 405
MethodNotAllowed
Descrizione
La risorsa di destinazione non supporta il metodo HTTP utilizzato.
Risoluzione dei problemi
Il metodo HTTP nella richiesta (ad esempio, PUT, POST, DELETE o GET) non è consentito dalla risorsa di destinazione. Controllare se il metodo HTTP previsto è stato specificato correttamente e controllare la documentazione dell'API REST per verificare che l'operazione stia utilizzando il metodo HTTP corretto.Codici errore stato HTTP 409
NotAuthorizedOrResourceAlreadyExists
Descrizione
Non si dispone dell'autorizzazione per eseguire questa richiesta oppure la risorsa che si sta tentando di creare esiste già. Questo codice di errore viene restituito solo dalle operazioni di creazione, dove viene restituito invece del codice di errore NotAuthorizedOrNotFound più generale.
Risoluzione dei problemi
- Se la richiesta consiste nel creare una risorsa, verificare che la risorsa non esista già e che l'utente chiamante sia autorizzato a creare questo tipo di risorsa in questo compartimento.
- Verificare che l'utente si trovi in un gruppo che dispone delle autorizzazioni per lavorare con le risorse in un compartimento. Per ulteriori informazioni sulle autorizzazioni, vedere Riferimento criteri.
InvalidatedRetryToken
Descrizione
Il token di nuovo tentativo fornito è stato utilizzato in una richiesta precedente che ha provocato un aggiornamento del sistema, ma un'operazione successiva ha invalidato il token. Ciò può verificarsi nei casi in cui un'entità creata con lo stesso token è stata successivamente eliminata. Se la modifica dello stato del sistema associata a questa richiesta deve essere eseguita di nuovo, utilizzare un token diverso.
Risoluzione dei problemi
Controllare il codice sorgente e verificare che il token di nuovo tentativo sia utilizzato correttamente.ExternalServerIncorrectState
Descrizione
Il server si trova in uno stato errato e si è verificato il timeout, ha restituito una risposta non valida o non è raggiungibile.
Risoluzione dei problemi
Provare quanto segue:
- Controllare il messaggio di errore per ulteriori dettagli. Potrebbe essere necessario riavviare il server e assicurarsi che sia accessibile dai servizi Oracle.
- Controllare i log degli errori sul server per informazioni utili.
- Il server potrebbe aver riscontrato un problema temporaneo. Attendere un attimo, quindi riprovare la richiesta.
- Se la richiesta non riesce ancora, contattare il supporto tecnico OCI e includere l'opc-request-id dalla richiesta o dalla risposta HTTP non riuscita.
IncorrectState
Descrizione
Lo stato richiesto per la risorsa è in conflitto con lo stato corrente, ma è stato specificato un periodo di tempo che sarà nello stato corretto.
Risoluzione dei problemi
Provare quanto segue:
- Controllare le dipendenze delle risorse. Impossibile eliminare una risorsa se è ancora utilizzata da altre risorse.
- Riprovare più tardi la richiesta o aggiornare il codice in modo da attendere il raggiungimento dello stato corretto prima di eseguire questa azione. Alcune operazioni richiedono che la risorsa si trovi in un determinato stato (ad esempio, in esecuzione).
Conflitto
Descrizione
Lo stato richiesto per la risorsa è in conflitto con lo stato corrente. Questo stato non è transitorio.
Risoluzione dei problemi
Controllare lo stato della risorsa richiesta e riprovare.ResourceLocked
Descrizione
La risorsa richiesta è bloccata. Questo in genere è dovuto al fatto che la risorsa è in uso attivo oppure perché la modifica della risorsa comporta l'interruzione del funzionamento di un'altra risorsa.
Risoluzione dei problemi
Controllare la risorsa per i dettagli sul lock. Potresti essere in grado di chiamare un'API per rimuovere il lock sulla risorsa oppure potresti essere in grado di passare un parametro all'API per ignorare il lock ed eseguire l'operazione richiesta.
Se il blocco è stato posizionato sulla risorsa da un servizio esterno, potrebbe non essere possibile rimuovere il blocco. Ad esempio, gli amministratori delle tenancy padre possono creare quote bloccate in una tenancy figlio e gli amministratori della tenancy figlio non possono modificare le quote.
Alcuni lock specificano una risorsa correlata in cui è necessario eliminare la risorsa correlata per rimuovere il lock su questa risorsa.
Codici errore stato HTTP 412
NoEtagMatch
Descrizione
Il valore ETag specificato nel campo if-match della richiesta non corrisponde al valore ETag della risorsa.
Risoluzione dei problemi
Correggere ETag nella richiesta se non è previsto. Per ulteriori informazioni su ETags, consultare la documentazione sull'etichetta.
Codici errore stato HTTP 413
PayloadTooLarge
Descrizione
L'entità richiesta è maggiore dei limiti definiti dal server.
Risoluzione dei problemi
Provare a inviare una richiesta di dimensioni inferiori.
Codici errore stato HTTP 422
UnprocessableEntity
Descrizione
Il payload è sintatticamente corretto ma semanticamente non valido.
Risoluzione dei problemi
Impossibile per il servizio elaborare la richiesta. Controllare la richiesta e riformattare se necessario.
Codici errore stato HTTP 429
TooManyRequests
Descrizione
Hai inviato troppe richieste alle API di Oracle Cloud Infrastructure troppo rapidamente.
Risoluzione dei problemi
Questo è causato da troppe richieste in un piccolo lasso di tempo. Se il servizio dispone di meccanismi di limitazione, un numero eccessivo di richieste in un breve periodo di tempo comporterà il rifiuto di alcune richieste. Provare ad aggiungere alcuni ritardi tra le richieste per evitare questo errore.
Codici errore stato HTTP 431
RequestHeaderFieldsTooLarge
Descrizione
Le intestazioni HTTP nella richiesta sono troppo lunghe.
Risoluzione dei problemi
La richiesta può essere risottomessa dopo aver ridotto le dimensioni delle intestazioni della richiesta.
Codici errore stato HTTP 500
InternalServerError
Descrizione
Si è verificato un errore interno del server.
Risoluzione dei problemi
Il servizio non è riuscito a elaborare la richiesta per motivi sconosciuti. Questo è di solito un problema sul lato del servizio, probabilmente a causa di un'interruzione temporanea del servizio o di un bug. Riprovare inviando la stessa richiesta. Se il nuovo tentativo non riesce, contattare il supporto tecnico OCI e includere il file opc-request-id dalla richiesta o dalla risposta HTTP non riuscita nel messaggio.
Codici errore stato HTTP 501
MethodNotImplemented
Descrizione
La destinazione della richiesta HTTP non riconosce il metodo HTTP.
Risoluzione dei problemi
Il metodo HTTP nella richiesta non è implementato nel servizio. Per informazioni sull'operazione, fare riferimento alla documentazione dell'API REST e aggiornare la richiesta per utilizzare il metodo HTTP corretto per l'operazione.