Partager via

Azure Translator dans les codes de réponse et messages des outils Foundry

Lorsque vous utilisez HTTP le protocole pour accéder au contenu sur un serveur en cours d’exécution IIS, le serveur retourne un code numérique indiquant le résultat de la demande et la nature de la réponse, y compris sa réussite ou son échec. Le premier chiffre du code d’état catégorise la classe de réponse, tandis que les deux derniers chiffres n’ont aucun but de classification. Le premier chiffre peut être l’une des cinq valeurs suivantes :

  • 1xx (Informational) : réponse intermédiaire indiquant que la demande a été reçue et que le traitement se poursuit.
  • 2xx (Réussite) : le serveur a correctement reçu et accepté la demande du client.
  • 3xx (redirection) : une action supplémentaire est nécessaire pour terminer la demande.
  • 4xx (Erreur du client) : une erreur s’est produite à l’origine du navigateur client et ne peut pas être remplie.
  • 5xx (Erreur du serveur) : le serveur a rencontré une erreur et la demande a échoué.

Codes d’état

Voici les codes d’état HTTP qu’une demande peut retourner.

Code de statut Descriptif
200 Opération réussie.
400 L’un des paramètres de requête est manquant ou non valide. Corrigez les paramètres de demande avant de réessayer.
401 La demande n’a pas pu être authentifiée. Vérifiez que les informations d’identification sont spécifiées et valides.
403 La requête n’est pas autorisée. Vérifiez le message d’erreur détaillé. Ce code d’état indique souvent que vous avez utilisé toutes les traductions gratuites fournies avec un abonnement d’essai.
408 La demande n’a pas pu être remplie, car une ressource est manquante. Vérifiez le message d’erreur détaillé. Lorsque la demande inclut une catégorie personnalisée, ce code d’état indique souvent que le système de traduction personnalisé n’est pas encore disponible pour traiter les demandes. La demande doit être retentée après une période d’attente (par exemple, 1 minute).
429 Le serveur a rejeté la demande, car le client a dépassé les limites de requête.
500 Une erreur inattendue s’est produite. Si l’erreur persiste, signalez-la avec : date et heure de l’échec, identificateur de demande de l’en-tête de réponse X-RequestId et identificateur client de l’en-tête de requête X-ClientTraceId.
503 Serveur temporairement indisponible. Relancez la requête. Si l’erreur persiste, signalez-la avec : date et heure de l’échec, identificateur de demande de l’en-tête de réponse X-RequestId et identificateur client de l’en-tête de requête X-ClientTraceId.

Si une erreur se produit, la requête retourne une réponse d’erreur JSON. Le code d’erreur est un nombre à 6 chiffres combinant le code d’état HTTP à 3 chiffres suivi d’un nombre à 3 chiffres pour catégoriser davantage l’erreur :

Codes d’erreur

Une réponse d’erreur standard est un objet JSON avec une paire nom/valeur nommée error. La valeur est également un objet JSON avec des propriétés :

  • code: code d’erreur défini par le serveur.
  • message: chaîne donnant une représentation lisible par l’homme de l’erreur.

Par exemple, un client disposant d’un abonnement d’essai gratuit reçoit l’erreur suivante une fois que le quota gratuit est épuisé :

{
  "error": {
    "code":403001,
    "message":"The operation isn't allowed because the subscription has exceeded its free quota."
    }
}

Le code d’erreur est un nombre à 6 chiffres qui combine le code d’état HTTP à 3 chiffres et un nombre à 3 chiffres qui sert à catégoriser plus précisément l’erreur. Voici les codes d’erreur courants :

Code Descriptif
400000 Une des requêtes d’entrées n’est pas valide.
400001 Le paramètre « scope » n’est pas valide.
400002 Le paramètre « category » n’est pas valide.
400003 Un spécificateur de langage est manquant ou non valide.
400004 Un spécificateur de script cible (« To script ») est manquant ou non valide.
400005 Un texte d’entrée est manquant ou non valide.
400006 La combinaison de langue et de script n’est pas valide.
400018 Un spécificateur de script source (« From script ») est manquant ou non valide.
400019 L’une des langues spécifiées n’est pas prise en charge.
400020 L’un des éléments du tableau de texte d’entrée n’est pas valide.
400021 Le paramètre de version d’API est manquant ou non valide.
400023 L’une des paires de langues spécifiées n’est pas valide.
400035 La langue source (champ « From ») n’est pas valide.
400036 La langue cible (champ « To ») est manquante ou non valide.
400042 L’une des options spécifiées (champ « Options ») n’est pas valide.
400043 L’ID de trace client (champ ClientTraceId ou en-tête X-ClientTraceId) est manquant ou non valide.
400050 Le texte d’entrée est trop long. Affichez les limites de requête.
400064 Le paramètre « translation » est manquant ou non valide.
400070 Le nombre de scripts de cible (paramètre ToScript) ne correspond pas au nombre de langages cible (paramètre To).
400071 La valeur n’est pas valide pour TextType.
400072 Le tableau de texte d’entrée compte trop d’éléments.
400073 Le paramètre de script n’est pas valide.
400074 Le corps de la requête n’est pas un élément JSON valide.
400075 La combinaison de paire de langue et de catégorie n’est pas valide.
400077 La taille maximale de la demande est dépassée. Affichez les limites de requête.
400079 Le système personnalisé demandé pour la traduction entre le langage source et le langage cible n’existe pas.
400080 La translittération n’est pas prise en charge pour la langue ou le script.
401000 La demande n’est pas autorisée, car les informations d’identification sont manquantes ou non valides.
401015 « Les informations d’identification fournies concernent l’API Speech. Cette demande nécessite des informations d’identification pour l’API Texte. Utilisez un abonnement à Translator. »
403000 L’opération n’est pas autorisée.
403001 L’opération n’est pas autorisée, car l’abonnement a dépassé son quota gratuit.
405000 La méthode de requête n’est pas prise en charge pour la ressource demandée.
408001 Le système de traduction demandé est en cours de préparation. Réessayez dans quelques minutes.
408002 Le délai d’attente de la requête a expiré sur le flux entrant. Le client n’a pas produit de requête dans la limite du délai pendant lequel le serveur était préparé à attendre. Le client peut répéter la requête sans modification à tout moment.
415000 L’en-tête Content-Type est manquant ou non valide.
429000, 429001, 429002 Le serveur a rejeté la demande, car le client a dépassé les limites de requête.
500 000 Une erreur inattendue s’est produite. Si l’erreur persiste, signalez-la avec la date/l’heure d’erreur, l’identificateur de demande de l’en-tête de réponse X-RequestId et l’identificateur client de l’en-tête de requête X-ClientTraceId.
503000 Le service est temporairement indisponible. Réessayez. Si l’erreur persiste, signalez-la avec la date/l’heure d’erreur, l’identificateur de demande de l’en-tête de réponse X-RequestId et l’identificateur client de l’en-tête de requête X-ClientTraceId.
  • Last updated on