Compartir a través de


Mensajes y códigos de respuesta de Azure Translator en Foundry Tools

Cuando se usa HTTP el protocolo para acceder al contenido en un servidor que ejecuta IIS, el servidor devuelve un código numérico que indica el resultado de la solicitud y la naturaleza de la respuesta, incluido su éxito o error. El primer dígito del código de estado clasifica la clase de respuesta, mientras que los dos últimos dígitos no tienen ningún propósito de clasificación. El primer dígito puede ser uno de los cinco valores:

  • 1xx (Informativo): respuesta provisional que indica que la solicitud se recibió y continúa el procesamiento.
  • 2xx (correcto): el servidor recibió y aceptó correctamente la solicitud de cliente.
  • 3xx (Redireccionamiento): se requiere más acción para completar la solicitud.
  • 4xx (error de cliente): se produjo un error que se originó con el explorador cliente y no se puede cumplir.
  • 5xx (Error del servidor): el servidor encontró un error y se produjo un error en la solicitud.

Códigos de estado

A continuación se indican los códigos de estado HTTP posibles que devuelve una solicitud.

Código de estado Descripción
200 Éxito.
400 Uno de los parámetros de consulta falta o no es válido. Corrija los parámetros de la solicitud antes de volver a intentarlo.
401 No se pudo autenticar la solicitud. Compruebe que las credenciales se especifican y son válidas.
403 La solicitud no está autorizada. Compruebe el mensaje de error de detalles. Este código de estado suele indicar que ha usado todas las traducciones gratuitas proporcionadas con una suscripción de prueba.
408 No se pudo completar la solicitud porque falta un recurso. Compruebe el mensaje de error de detalles. Cuando la solicitud incluye una categoría personalizada, este código de estado suele indicar que el sistema de traducción personalizado aún no está disponible para atender solicitudes. La solicitud debe reintentarse después de un período de espera (por ejemplo, 1 minuto).
429 El servidor rechazó la solicitud porque el cliente superó los límites de solicitud.
500 Error inesperado. Si el error persiste, notifique con: fecha y hora del error, identificador de solicitud del encabezado de respuesta X-RequestId y identificador de cliente del encabezado de solicitud X-ClientTraceId.
503 Servidor no disponible temporalmente. Intente de nuevo la solicitud. Si el error persiste, notifique con: fecha y hora del error, identificador de solicitud del encabezado de respuesta X-RequestId y identificador de cliente del encabezado de solicitud X-ClientTraceId.

Si se produce un error, la solicitud devuelve una respuesta de error JSON. El código de error es un número de 6 dígitos que combina el código de estado HTTP de 3 dígitos seguido de un número de 3 dígitos para clasificar aún más el error:

Códigos de error

Una respuesta de error estándar es un objeto JSON con el par nombre-valor denominado error. El valor también es un objeto JSON con propiedades:

  • code: código de error definido por el servidor.
  • message: cadena que proporciona una representación legible del error.

Por ejemplo, un cliente con una suscripción de evaluación gratuita recibiría el siguiente error una vez agotada la cuota gratuita:

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

El código de error es un número de 6 dígitos que combina el código de estado HTTP de 3 dígitos y otro número de 3 dígitos que ayuda a categorizar aún más el error. Los códigos de error comunes son:

Código Descripción
400000 Una de las entradas de la solicitud no es válida.
400001 El parámetro "scope" no es válido.
400002 El parámetro "category" no es válido.
400003 Falta un especificador de lenguaje o no es válido.
400004 Falta un especificador de script de destino ("To script") o no es válido.
400005 Falta un texto de entrada o no es válido.
400006 La combinación de lenguaje y script no es válida.
400018 Falta un especificador de script de origen ("From script") o no es válido.
400019 No se admite uno de los lenguajes especificados.
400020 Uno de los elementos de la matriz de texto de entrada no es válido.
400021 Falta un parámetro de la versión de API o no es válido.
400023 Uno de los pares de lenguaje especificados no es válido.
400035 El lenguaje fuente (campo "From") no es válido.
400036 Falta el lenguaje de destino (campo "To") o no es válido.
400042 Una de las opciones especificadas (campo "Options") no es válida.
400043 El identificador de seguimiento de cliente (campo ClientTraceId o encabezado X-ClientTraceId) falta o no es válido.
400050 El texto de entrada es demasiado largo. Consulte los límites de solicitud.
400064 Falta un parámetro "translation" o no es válido.
400070 El número de scripts de destino (parámetro ToScript) no coincide con el número de lenguajes de destino (parámetro To).
400071 Valor no válido para TextType.
400072 La matriz de texto de entrada tiene demasiados elementos.
400073 El parámetro de script no es válido.
400074 El cuerpo de la solicitud no es un JSON válido.
400075 La combinación de categoría y par de lenguaje no es válida.
400077 Se supera el tamaño máximo de la solicitud. Consulte los límites de solicitud.
400079 El sistema personalizado solicitado para la traducción entre, desde y hacia el lenguaje no existe.
400080 La transliteración no se admite para el idioma o el script.
401000 La solicitud no está autorizada porque faltan credenciales o no son válidas.
401015 "Las credenciales proporcionadas son para Speech API. Esta solicitud requiere credenciales para Text API. Use una suscripción a Translator".
403000 No se permite la operación.
403001 No se permite la operación porque la suscripción superó su cuota gratuita.
405000 El método de solicitud no se admite para el recurso solicitado.
408001 Se está preparando el sistema de traducción solicitado. Vuelva a intentarlo en unos minutos.
408002 La solicitud superó el tiempo de espera mientras se esperaba la secuencia entrante. El cliente no presentó una solicitud en el tiempo que el servidor estaba preparado para esperar. El cliente puede repetir la solicitud sin modificaciones en cualquier momento posterior.
415000 Falta el encabezado Content-Type o no es válido.
429000, 429001, 429002 El servidor rechazó la solicitud porque el cliente superó los límites de solicitud.
500000 Error inesperado. Si el error persiste, notifique la fecha y hora del error, el identificador de solicitud del encabezado de respuesta X-RequestId y el identificador de cliente del encabezado de solicitud X-ClientTraceId.
503000 El servicio no está disponible temporalmente. Vuelva a intentarlo. Si el error persiste, notifique la fecha y hora del error, el identificador de solicitud del encabezado de respuesta X-RequestId y el identificador de cliente del encabezado de solicitud X-ClientTraceId.