Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Quando si usa il HTTP
protocollo per accedere al contenuto in un server che esegue IIS
, il server restituisce un codice numerico che indica il risultato della richiesta e la natura della risposta, incluso l'esito positivo o negativo.
La prima cifra del codice di stato classifica la classe di risposta, mentre le ultime due cifre non servono a scopo di classificazione. La prima cifra può essere uno dei cinque valori seguenti:
- 1xx (Informativo): risposta provvisoria che indica che la richiesta è stata ricevuta ed elaborazione continua.
- 2xx (operazione riuscita): il server ha ricevuto e accettato la richiesta client.
- 3xx (reindirizzamento): per completare la richiesta è necessaria un'altra azione.
- 4xx (Errore client): si è verificato un errore che ha avuto origine con il browser client e non può essere soddisfatto.
- 5xx (errore del server): il server ha rilevato un errore e la richiesta non è riuscita.
Codici di stato
Di seguito sono riportati i possibili codici di stato HTTP restituiti da una richiesta.
Codice di stato | Descrizione |
---|---|
200 | Successo. |
400 | Uno dei parametri di query manca o non è valido. Prima di riprovare, correggere i parametri della richiesta. |
401 | Impossibile autenticare la richiesta. Verificare che le credenziali siano specificate e valide. |
403 | La richiesta non è autorizzata. Controllare il messaggio di errore dei dettagli. Questo codice di stato indica spesso che sono state usate tutte le traduzioni gratuite fornite con una sottoscrizione di valutazione. |
408 | Impossibile soddisfare la richiesta perché manca una risorsa. Controllare il messaggio di errore dei dettagli. Quando la richiesta include una categoria personalizzata, questo codice di stato spesso indica che il sistema di traduzione personalizzato non è ancora disponibile per gestire le richieste. La richiesta deve essere ritentata dopo un periodo di attesa (ad esempio, 1 minuto). |
429 | Il server ha rifiutato la richiesta perché il client ha superato i limiti delle richieste. |
500 | Errore imprevisto. Se l'errore persiste, segnalarlo con: data e ora dell'errore, identificatore della richiesta dall'intestazione di risposta X-RequestId e identificatore client dall'intestazione della richiesta X-ClientTraceId. |
503 | Il server è temporaneamente non disponibile. Ripetere la richiesta. Se l'errore persiste, segnalarlo con: data e ora dell'errore, identificatore della richiesta dall'intestazione di risposta X-RequestId e identificatore client dall'intestazione della richiesta X-ClientTraceId. |
Se si verifica un errore, la richiesta restituisce una risposta di errore JSON. Il codice di errore è un numero a 6 cifre che combina il codice di stato HTTP a 3 cifre seguito da un numero a 3 cifre per classificare ulteriormente l'errore:
Codici di errore
Una risposta di errore standard è un oggetto JSON con coppia nome/valore denominata error
. Il valore è anche un oggetto JSON con proprietà:
-
code
: codice di errore definito dal server. -
message
: stringa che fornisce una rappresentazione leggibile dell'errore.
Ad esempio, un cliente con una sottoscrizione di valutazione gratuita riceverà l'errore seguente dopo l'esaurimento della quota gratuita:
{
"error": {
"code":403001,
"message":"The operation isn't allowed because the subscription has exceeded its free quota."
}
}
Il codice errore è un numero a 6 cifre che combina il codice di stato HTTP a 3 cifre seguito da un numero a 3 cifre per classificare ulteriormente l'errore. Codici errore comuni sono:
Codice | Descrizione |
---|---|
400000 | Uno degli input della richiesta non è valido. |
400001 | Il parametro "scope" non è valido. |
400002 | Il parametro "category" non è valido. |
400003 | Un identificatore di lingua manca o non è valido. |
400004 | Un identificatore di script di destinazione ("To script") manca o non è valido. |
400005 | Un testo di input manca o non è valido. |
400006 | La combinazione di lingua e script non è valida. |
400018 | Un identificatore di script di origine ("From script") manca o non è valido. |
400019 | Una delle lingue specificate non è supportata. |
400020 | Uno degli elementi nella matrice del testo di input non è valido. |
400021 | Il parametro della versione API manca o non è valido. |
400023 | Una delle coppie di lingue specificata non è valida. |
400035 | La lingua di origine (campo "From") non è valida. |
400036 | La lingua di destinazione (campo "To") manca o non è valida. |
400042 | Una delle opzioni specificate (campo "Options") non è valida. |
400043 | L'ID traccia client (campo ClientTraceId o intestazione X-ClientTraceId) è mancante o non valido. |
400050 | Il testo di input è troppo lungo. Vedere i limiti delle richieste. |
400064 | Il parametro "translation" manca o non è valido. |
400070 | Il numero di script di destinazione (parametro ToScript) non corrisponde al numero di lingue di destinazione (parametro To). |
400071 | Il valore non è valido per TextType. |
400072 | La matrice del testo di input contiene troppi elementi. |
400073 | Il parametro script non è valido. |
400074 | Il corpo della richiesta non è in formato JSON valido. |
400075 | La combinazione di coppia di lingue e categoria non è valida. |
400077 | Viene superata la dimensione massima della richiesta. Vedere i limiti delle richieste. |
400079 | Il sistema personalizzato richiesto per la traduzione da/verso la lingua non esiste. |
400080 | La traslitterazione non è supportata per la lingua o lo script. |
401000 | La richiesta non è autorizzata perché le credenziali sono mancanti o non valide. |
401015 | "Le credenziali fornite sono per l'API Voce. Questa richiesta richiede credenziali per l'API Text. Usare una sottoscrizione a Translator." |
403000 | L'operazione non è consentita. |
403001 | L'operazione non è consentita perché la sottoscrizione ha superato la quota gratuita. |
405000 | Il metodo di richiesta non è supportato per la risorsa richiesta. |
408001 | È in corso la preparazione del sistema di traduzione richiesto. Riprovare tra qualche minuto. |
408002 | Timeout della richiesta in attesa del flusso in ingresso. Il client non ha generato una richiesta entro l'intervallo di attesa previsto per il server. Il client può ripetere la richiesta senza modifiche in un secondo momento. |
415000 | Intestazione Content-Type mancante o non valida. |
429000, 429001, 429002 | Il server ha rifiutato la richiesta perché il client ha superato i limiti delle richieste. |
500.000 | Errore imprevisto. Se l'errore persiste, segnalarlo con data/ora di errore, identificatore della richiesta dall'intestazione di risposta X-RequestId e identificatore client dall'intestazione della richiesta X-ClientTraceId. |
503000 | Il servizio è temporaneamente non disponibile. Riprova. Se l'errore persiste, segnalarlo con data/ora di errore, identificatore della richiesta dall'intestazione di risposta X-RequestId e identificatore client dall'intestazione della richiesta X-ClientTraceId. |