Guía de errores v4.0, v3.1 y v3.0

Document Intelligence utiliza un diseño unificado para representar todos los errores encontrados en las API REST. Cada vez que una operación de API devuelve un código de estado 4xx o 5xx, se devuelve información adicional sobre el error en el cuerpo JSON de la respuesta, como se indica a continuación:

{
  "error": {
    "code": "InvalidRequest",
    "message": "Invalid request.",
    "innererror": {
      "code": "InvalidContent",
      "message": "The file format is unsupported or corrupted. Refer to documentation for the list of supported formats."
    }
  }
}

En el caso de operaciones de larga ejecución en las que se detectan varios errores, el código de error de nivel superior se establece en el error más grave, y cada error se enumera con la propiedad error.details. En estos escenarios, la propiedad target de cada error especifica el desencadenador.

{
    "status": "failed",
    "createdDateTime": "2021-07-14T10:17:51Z",
    "lastUpdatedDateTime": "2021-07-14T10:17:51Z",
    "error": {
        "code": "InternalServerError",
        "message": "An unexpected error occurred.",
        "details": [
            {
                "code": "InternalServerError",
                "message": "An unexpected error occurred."
            },
            {
                "code": "InvalidContentDimensions",
                "message": "The input image dimensions are out of range. Refer to documentation for supported image dimensions.",
                "target": "2"
            }
        ]
    }
}

La propiedad error.code de nivel superior puede ser uno de los siguientes mensajes de código de error:

Código de error	Mensaje	Estado HTTP
InvalidRequest	Solicitud no válida.	400
InvalidArgument	Argumento no válido.	400
Prohibido	Acceso prohibido debido a una directiva u otra configuración.	403
NotFound	Recurso no encontrado.	404
MethodNotAllowed	No se admite el método HTTP solicitado.	405
Conflicto	La solicitud no se ha podido completar debido a un conflicto.	409
UnsupportedMediaType	No se admite el tipo de contenido de la solicitud.	415
InternalServerError	Se ha producido un error inesperado.	500
ServiceUnavailable	Se ha producido un error transitorio. Inténtelo de nuevo.	503

Siempre que es posible, se especifican más detalles en la propiedad inner error.

Código de error superior	Código de error interno	Mensaje
Conflicto	ModelExists	Ya existe un modelo con el nombre proporcionado.
Prohibido	AuthorizationFailed	Error de autorización: {details}
Prohibido	InvalidDataProtectionKey	La clave de protección de datos no es válida: {details}
Prohibido	OutboundAccessForbidden	La solicitud contiene un nombre de dominio que no está permitido o incumple la directiva de control de acceso actual.
InternalServerError	Unknown	Error desconocido.
InvalidArgument	InvalidContentSourceFormat	Origen de contenido no válido: {details}
InvalidArgument	InvalidParameter	El parámetro {parameterName} no es válido: {details}
InvalidArgument	InvalidParameterLength	El parámetro {parameterName} no puede tener una longitud superior a {maxChars} caracteres.
InvalidArgument	InvalidSasToken	La firma de acceso compartido (SAS) no es válida: {details}
InvalidArgument	ParameterMissing	El parámetro {parameterName} no es necesario.
InvalidRequest	ContentSourceNotAccessible	No se puede acceder al contenido: {details}
InvalidRequest	ContentSourceTimeout	Se ha agotado el tiempo de espera al recibir el archivo del cliente.
InvalidRequest	DocumentModelLimit	La cuenta no puede crear más de {maximumModels} modelos.
InvalidRequest	DocumentModelLimitNeural	La cuenta no puede crear más de 10 modelos neuronales personalizados al mes. Póngase en contacto con el soporte técnico para solicitar más capacidad.
InvalidRequest	DocumentModelLimitComposed	La cuenta no puede crear un modelo con más de {details} modelos de componentes.
InvalidRequest	InvalidContent	El archivo está dañado o tiene un formato no admitido. Consulte la lista de formatos admitidos en la documentación.
InvalidRequest	InvalidContentDimensions	Las dimensiones de la imagen de entrada están fuera del intervalo. Consulte las dimensiones de imagen admitidas en la documentación.
InvalidRequest	InvalidContentLength	La imagen de entrada es demasiado grande. Consulte el tamaño de archivo máximo en la documentación.
InvalidRequest	InvalidFieldsDefinition	Campos no válidos: {details}
InvalidRequest	InvalidTrainingContentLength	El contenido de entrenamiento tiene {bytes} bytes. El entrenamiento está limitado a {maxBytes} bytes.
InvalidRequest	InvalidTrainingContentPageCount	El contenido de entrenamiento tiene {pages} páginas. El entrenamiento está limitado a {pages} páginas.
InvalidRequest	ModelAnalyzeError	No se ha podido realizar el análisis con un modelo personalizado: {details}
InvalidRequest	ModelBuildError	No se ha podido compilar el modelo: {details}
InvalidRequest	ModelComposeError	No se ha podido crear el modelo: {details}
InvalidRequest	ModelNotReady	El modelo no está listo para la operación solicitada. Espere a que se complete el entrenamiento o compruebe si hay errores de operación.
InvalidRequest	ModelReadOnly	El modelo solicitado es de solo lectura.
InvalidRequest	NotSupportedApiVersion	La operación solicitada requiere {minimumApiVersion} o posterior.
InvalidRequest	OperationNotCancellable	La operación ya no se puede cancelar.
InvalidRequest	TrainingContentMissing	Faltan datos de entrenamiento: {details}
InvalidRequest	UnsupportedContent	No se admite el contenido: {details}
NotFound	ModelNotFound	No se ha encontrado el modelo solicitado. Se ha eliminado o se sigue compilando.
NotFound	OperationNotFound	No se ha encontrado la operación solicitada. El identificador no es válido o la operación ha expirado.