Condividi tramite


Codici di risposta e messaggi di Azure AI Translator

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.