Códigos de error de Face API de Azure AI

Códigos de error comunes

Estas llamadas a Face API pueden devolver estos códigos de error.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	El cuerpo de la solicitud no es válido.
Solicitud incorrecta (400)	BadArgument	Error de análisis de JSON.	Cuerpo JSON de solicitud incorrecto o no reconocido.
Solicitud incorrecta (400)	BadArgument	"recognitionModel" no es válido.
Solicitud incorrecta (400)	BadArgument	"detectionModel" no es válido.
Solicitud incorrecta (400)	BadArgument	'name' está vacío.
Solicitud incorrecta (400)	BadArgument	'name' es demasiado largo.
Solicitud incorrecta (400)	BadArgument	"userData" es demasiado largo.
Solicitud incorrecta (400)	BadArgument	'start' es demasiado largo.
Solicitud incorrecta (400)	BadArgument	'top' no es válido.
Solicitud incorrecta (400)	BadArgument	TargetFace de argumento fuera del intervalo.
Solicitud incorrecta (400)	BadArgument	TargetFace de argumento no válido.	Causado por un formato de cadena no válido o por un valor de alto/ancho o izquierdo no válido.
Solicitud incorrecta (400)	InvalidURL	Dirección URL de imagen no válida.	Entre los formatos admitidos se incluyen JPEG, PNG, GIF(el primer fotograma) y BMP.
Solicitud incorrecta (400)	InvalidURL	Dirección URL de imagen no válida o error al descargar desde el servidor de destino. Error de servidor remoto devuelto: "Error al enviar la solicitud".
Solicitud incorrecta (400)	InvalidImage	Error de descodificación, formato de imagen no admitido.
Solicitud incorrecta (400)	InvalidImage	No se detectó ninguna cara en la imagen.
Solicitud incorrecta (400)	InvalidImage	Hay más de 1 cara en la imagen.
Solicitud incorrecta (400)	InvalidImageSize	El tamaño de la imagen es demasiado pequeño.	El tamaño de archivo de imagen válido debe ser mayor o igual que 1 KB.
Solicitud incorrecta (400)	InvalidImageSize	El tamaño de la imagen es demasiado grande.	El tamaño de archivo de imagen válido no debe tener más de 6 MB.
No autorizado (401)	401	Acceso denegado debido a una clave de suscripción no válida o a un punto de conexión de API incorrecto. Asegúrese de proporcionar una clave válida para una suscripción activa y de usar un punto de conexión de API regional correcto para el recurso.
Conflicto (409)	ConcurrentOperationConflict	Hay una operación de conflicto en el recurso <resourceName>, pruebe más adelante.
Demasiadas solicitudes (429)	429	Rate limit is exceeded. (El límite de velocidad se ha excedido.)

Códigos de error de detección de caras

La operación detección de caras puede devolver estos códigos de error.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	Argumento returnFaceAttributes no válido.
Solicitud incorrecta (400)	BadArgument	"returnFaceAttributes" no es compatible con detection_02.
Solicitud incorrecta (400)	BadArgument	"returnLandmarks" no es compatible con detection_02.

Códigos de error de sesión de Face Liveness

Estas operaciones de sesión de Face Liveness pueden devolver estos códigos de error.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	El parámetro Start no es válido. Especifique el campo "Id" de la última entrada para continuar con el proceso de descripción.
Solicitud incorrecta (400)	BadArgument	El parámetro top no es válido. El intervalo válido está comprendido entre 1 y 1000 inclusive.
Solicitud incorrecta (400)	InvalidRequestBody	Cuerpo de solicitud incorrecto proporcionado. Compruebe el esquema de la operación e inténtelo de nuevo.
Solicitud incorrecta (400)	InvalidTokenLifetime	authTokenTimeToLiveInSeconds no válidos especificados. Debe estar comprendido entre 60 y 86400.
Solicitud incorrecta (400)	InvalidLivenessOperationMode	Se especificó livenessOperationMode no válido. Debe ser "Pasivo".
Solicitud incorrecta (400)	InvalidDeviceCorrelationId	Se requiere un identificador de correlación de dispositivo en el cuerpo de la solicitud durante el inicio de la sesión o la creación de la sesión. No debe ser null ni estar vacío y no tener más de 64 caracteres.
No encontrado (404)	SessionNotFound	No se encuentra el identificador de sesión. El identificador de sesión ha expirado o no existe.

Códigos de error de Face Identify

La operación Face Identify puede devolver estos códigos de error.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	'recognitionModel' no es compatible.
Solicitud incorrecta (400)	BadArgument	El identificador de grupo de personas no es válido.
Solicitud incorrecta (400)	BadArgument	El identificador de grupo de personas grandes no es válido.
Solicitud incorrecta (400)	BadArgument	El identificador de grupo de personas dinámico no es válido.
Solicitud incorrecta (400)	BadArgument	El argumento maxNumOfCandidatesReturned no es válido.	El intervalo válido está entre [1, 100].
Solicitud incorrecta (400)	BadArgument	El argumento confidenceThreshold no es válido.	El intervalo válido está entre [0, 1].
Solicitud incorrecta (400)	BadArgument	La longitud de faceIds no está en un intervalo válido.	El intervalo válido está entre [1, 10].
Solicitud incorrecta (400)	FaceNotFound	No se encuentra la cara.
Solicitud incorrecta (400)	PersonGroupNotFound	No se encuentra el grupo de personas.
Solicitud incorrecta (400)	LargePersonGroupNotFound	No se encuentra el grupo de personas grandes.
Solicitud incorrecta (400)	DynamicPersonGroupNotFound	No se encuentra el grupo de personas dinámicas.
Solicitud incorrecta (400)	PersonGroupNotTrained	Grupo de personas no entrenado.
Solicitud incorrecta (400)	LargePersonGroupNotTrained	Grupo de personas grandes no entrenado.
Solicitud incorrecta (400)	PersonGroupIdAndLargePersonGroupIdBothNotNull	El identificador de grupo de personas grandes y el identificador de grupo de personas no son NULL.
Solicitud incorrecta (400)	PersonGroupIdAndLargePersonGroupIdBothNull	El identificador de grupo de personas grandes y el identificador de grupo de personas son null.
Solicitud incorrecta (400)	MissingIdentificationScopeParameters	No hay ningún parámetro de ámbito de identificación presente en la solicitud.
Solicitud incorrecta (400)	IncompatibleIdentificationScopeParametersCombination	Los parámetros de ámbito de identificación incompatibles están presentes en la solicitud.
Conflicto (409)	PersonGroupTrainingNotFinished	El grupo de personas está en entrenamiento.
Conflicto (409)	LargePersonGroupTrainingNotFinished	El grupo de personas grandes está en entrenamiento.

Códigos de error de Face Verify

La operación Face Verify puede devolver estos códigos de error.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	'recognitionModel' no es compatible.
Solicitud incorrecta (400)	BadArgument	Face ID no es válido.	Un faceId válido procede de Face - Detect.
Solicitud incorrecta (400)	BadArgument	El identificador de persona no es válido.	Se genera un personId válido a partir de Crear persona del grupo de personas, Crear persona de grupo grande o Directorio de personas: crear persona.
Solicitud incorrecta (400)	BadArgument	El identificador de grupo de personas no es válido.
Solicitud incorrecta (400)	BadArgument	El identificador de grupo de personas grandes no es válido.
Solicitud incorrecta (400)	PersonNotFound	No se encuentra la persona.
Solicitud incorrecta (400)	PersonGroupNotFound	No se encuentra el grupo de personas.
Solicitud incorrecta (400)	LargePersonGroupNotFound	No se encuentra el grupo de personas grandes.
No encontrado (404)	FaceNotFound	No se encuentra la cara.
No encontrado (404)	PersonNotFound	No se encuentra la persona.
No encontrado (404)	PersistedFaceNotFound	No se encuentra ninguna cara persistente de la persona.

Buscar códigos de error similares

La operación Face Find Similar puede devolver estos códigos de error.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	'recognitionModel' no es compatible.
Solicitud incorrecta (400)	BadArgument	El modo no es válido.
Solicitud incorrecta (400)	BadArgument	El identificador de lista de caras no es válido.
Solicitud incorrecta (400)	BadArgument	El identificador de lista de caras grandes no es válido.
Solicitud incorrecta (400)	BadArgument	LargeFaceListId, faceListId y faceIds, no exactamente uno de ellos es válido.
Solicitud incorrecta (400)	BadArgument	LargeFaceListId, faceListId y faceIds son null.
Solicitud incorrecta (400)	BadArgument	2 o más de largeFaceListId, faceListId y faceIds no son NULL.
Solicitud incorrecta (400)	BadArgument	El argumento maxNumOfCandidatesReturned no es válido.	El intervalo válido está entre [1, 1000].
Solicitud incorrecta (400)	BadArgument	La longitud de faceIds no está en un intervalo válido.	El intervalo válido está entre [1, 1000].
Solicitud incorrecta (400)	FaceNotFound	No se encuentra la cara.
Solicitud incorrecta (400)	FaceListNotFound	No se encuentra la lista de caras.
Solicitud incorrecta (400)	LargeFaceListNotFound	No se encuentra la lista de caras grandes.
Solicitud incorrecta (400)	LargeFaceListNotTrained	La lista de caras grandes no está entrenada.
Solicitud incorrecta (400)	FaceListNotReady	La lista de caras está vacía.
Conflicto (409)	LargeFaceListTrainingNotFinished	La lista de caras grandes está en entrenamiento.

Códigos de error del grupo de caras

La operación Face Group puede devolver estos códigos de error.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	'recognitionModel' no es compatible.
Solicitud incorrecta (400)	BadArgument	La longitud de faceIds no está en un intervalo válido.	El intervalo válido está entre [2, 1000].

Operaciones de grupo de personas

Estas operaciones de grupo de personas pueden devolver estos códigos de error.

Códigos de error del grupo de personas

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	El identificador de grupo de personas no es válido.	El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64.
Prohibido (403)	QuotaExceeded	El número de grupo de personas alcanzó el límite de nivel de suscripción.
Prohibido (403)	QuotaExceeded	El número de persona alcanzó el límite de nivel de grupo de personas.
Prohibido (403)	QuotaExceeded	El número de persona alcanzó el límite de nivel de suscripción.
Prohibido (403)	QuotaExceeded	Se alcanzó el límite de número de cara persistente.
No encontrado (404)	PersonGroupNotFound	No se encuentra el grupo de personas.
No encontrado (404)	PersonGroupNotFound	El identificador de grupo de personas no es válido.
No encontrado (404)	PersonNotFound	No se encuentra la persona <personId> .
No encontrado (404)	PersonNotFound	El identificador de persona no es válido.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara persistente.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara <faceId> persistente.
No encontrado (404)	PersistedFaceNotFound	El identificador de cara persistente no es válido.
No encontrado (404)	PersonGroupNotTrained	Grupo de personas no entrenado.	Este error aparece al obtener el estado de entrenamiento de un grupo que nunca se ha entrenado.
Conflicto (409)	PersonGroupExists	El grupo de personas ya existe.
Conflicto (409)	PersonGroupTrainingNotFinished	El grupo de personas está en entrenamiento.	Inténtelo de nuevo después de completar el entrenamiento.

Códigos de error del grupo de personas grandes

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	El identificador de grupo de personas grandes no es válido.	El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64.
Solicitud incorrecta (400)	BadArgument	Tanto 'name' como 'userData' están vacíos.
Prohibido (403)	QuotaExceeded	El número de grupo de personas grandes alcanzó el límite de nivel de suscripción.
Prohibido (403)	QuotaExceeded	El número de persona alcanzó el límite de nivel de grupo de personas grandes.
Prohibido (403)	QuotaExceeded	El número de persona alcanzó el límite de nivel de suscripción.
Prohibido (403)	QuotaExceeded	Se alcanzó el límite de número de cara persistente.
No encontrado (404)	LargePersonGroupNotFound	No se encuentra el grupo de personas grandes.
No encontrado (404)	LargePersonGroupNotFound	El identificador de grupo de personas grandes no es válido.
No encontrado (404)	PersonNotFound	No se encuentra la persona <personId> .
No encontrado (404)	PersonNotFound	El identificador de persona no es válido.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara persistente.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara <faceId> persistente.
No encontrado (404)	PersistedFaceNotFound	El identificador de cara persistente no es válido.
No encontrado (404)	LargePersonGroupNotTrained	Grupo de personas grandes no entrenado.	Este error aparece al obtener el estado de entrenamiento de un grupo que nunca se ha entrenado.
Conflicto (409)	LargePersonGroupExists	Ya existe un grupo de personas grandes.
Conflicto (409)	LargePersonGroupTrainingNotFinished	El grupo de personas grandes está en entrenamiento.	Inténtelo de nuevo después de completar el entrenamiento.

Operaciones de lista de caras

Estas operaciones de Face List pueden devolver estos códigos de error.

Códigos de error de la lista de caras

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	El identificador de lista de caras no es válido.	El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64.
Prohibido (403)	QuotaExceeded	Se alcanzó el límite de número de cara persistente.
No encontrado (404)	FaceListNotFound	No se encuentra la lista de caras.
No encontrado (404)	FaceListNotFound	El identificador de lista de caras no es válido.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara persistente.
No encontrado (404)	PersistedFaceNotFound	El identificador de cara persistente no es válido.
Conflicto (409)	FaceListExists	La lista de caras ya existe.

Códigos de error de la lista de caras grandes

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	El identificador de lista de caras grandes no es válido.	El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64.
Solicitud incorrecta (400)	BadArgument	Tanto 'name' como 'userData' están vacíos.
Prohibido (403)	QuotaExceeded	El número de lista de caras grandes alcanzó el límite.
Prohibido (403)	QuotaExceeded	Se alcanzó el límite de número de cara persistente.
No encontrado (404)	LargeFaceListNotFound	No se encuentra la lista de caras grandes.
No encontrado (404)	LargeFaceListNotFound	El identificador de lista de caras grandes no es válido.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara de lista de caras <faceId> grandes.
No encontrado (404)	PersistedFaceNotFound	El identificador de cara persistente no es válido.
No encontrado (404)	LargeFaceListNotTrained	Lista de caras grandes no entrenada.	Este error aparece al obtener el estado de entrenamiento de una lista de caras grande que nunca se ha entrenado.
Conflicto (409)	LargeFaceListExists	Ya existe una lista de caras grandes.
Conflicto (409)	LargeFaceListTrainingNotFinished	La lista de caras grandes está en entrenamiento.	Inténtelo de nuevo después de completar el entrenamiento.

Operaciones de Directorio de personas

Las operaciones de Person Directory pueden devolver estos códigos de error.

Códigos de error de Person Directory

Código de estado HTTP	Código de error	Mensaje de error	Descripción
Solicitud incorrecta (400)	BadArgument	El modelo de reconocimiento no se admite para esta característica.
Solicitud incorrecta (400)	BadArgument	'start' no es un identificador de persona válido.
Solicitud incorrecta (400)	BadArgument	Tanto 'name' como 'userData' están vacíos.
Solicitud incorrecta (400)	DynamicPersonGroupNotFound	El identificador de grupo de personas dinámico no es válido.
Prohibido (403)	QuotaExceeded	El número de persona alcanzó el límite de nivel de suscripción.
Prohibido (403)	QuotaExceeded	Se alcanzó el límite de número de cara persistente.
No encontrado (404)	DynamicPersonGroupNotFound	No se encontró el grupo de personas dinámicas.
No encontrado (404)	DynamicPersonGroupNotFound	No se encuentra DynamicPersonGroupPersonReference <groupId> .
No encontrado (404)	PersonNotFound	No se encuentra la persona.
No encontrado (404)	PersonNotFound	El identificador de persona no es válido.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara persistente.
No encontrado (404)	PersistedFaceNotFound	No se encuentra la cara <faceId> persistente.
No encontrado (404)	PersistedFaceNotFound	Face ID persistente no es válido.
Conflicto (409)	DynamicPersonGroupExists	El identificador <groupId> de grupo de personas dinámicas ya existe.

Pasos siguientes

• Referencia de Face API