Codes d’erreur de l’API Visage Azure AI

Article
09/01/2024

Codes d’erreur courants

Ces codes d’erreur peuvent être retournés par tous les appels d’API Visage.

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	Le corps de la demande n’est pas valide.
Demande incorrecte (400)	BadArgument	Erreur d’analyse JSON.	Corps JSON de requête incorrect ou non reconnaissable.
Demande incorrecte (400)	BadArgument	« recognitionModel » est non valable.
Demande incorrecte (400)	BadArgument	« detectionModel » est non valable.
Demande incorrecte (400)	BadArgument	'name' est vide.
Demande incorrecte (400)	BadArgument	'name' est trop long.
Demande incorrecte (400)	BadArgument	'userData' est trop long.
Demande incorrecte (400)	BadArgument	'start' est trop long.
Demande incorrecte (400)	BadArgument	'top' n’est pas valide.
Demande incorrecte (400)	BadArgument	Argument targetFace hors plage.
Demande incorrecte (400)	BadArgument	Argument targetFace non valide.	Cause d’un format de chaîne non valide ou d’une valeur gauche/supérieure/hauteur/largeur non valide.
Demande incorrecte (400)	InvalidURL	URL d’image non valide.	Les formats pris en charge sont les suivants : JPEG, PNG, GIF (le premier cadre) et BMP.
Demande incorrecte (400)	InvalidURL	URL d’image non valide ou téléchargement d’erreur à partir du serveur cible. Erreur du serveur distant retournée : « Une erreur s’est produite lors de l’envoi de la requête ».
Demande incorrecte (400)	InvalidImage	Erreur de décodage, format d’image non pris en charge.
Demande incorrecte (400)	InvalidImage	Aucun visage détecté dans l’image.
Demande incorrecte (400)	InvalidImage	Il y a plus de 1 visage dans l’image.
Demande incorrecte (400)	InvalidImageSize	La taille de l’image est trop petite.	La taille de fichier image valide doit être supérieure ou égale à 1 Ko.
Demande incorrecte (400)	InvalidImageSize	La taille de l’image est trop grande.	La taille de fichier image valide ne doit pas dépasser 6 Mo.
Non autorisé (401)	401	Accès refusé en raison d’une clé d’abonnement non valide ou d’un point de terminaison d’API incorrect. Veillez à fournir une clé valide pour un abonnement actif et à utiliser un point de terminaison d’API régional correct pour votre ressource.
Interdit (403)	UnsupportedFeature	La fonctionnalité n’est pas prise en charge, l’approbation manquante pour une ou plusieurs des fonctionnalités suivantes : Identification, vérification.	Inscrivez-vous à l’accès en envoyant un formulaire d’inscription.
Conflit (409)	ConcurrentOperationConflict	Il existe une opération de conflit sur la ressource `<resourceName>`, essayez ultérieurement.
Trop de demandes (429)	429	Limite de débit dépassée.

Codes d’erreur détection des visages

Ces codes d’erreur peuvent être retournés par l’opération Détection des visages.

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	Argument returnFaceAttributes non valable.
Demande incorrecte (400)	BadArgument	« returnFaceAttributes » n’est pas pris en charge par detection_02.
Demande incorrecte (400)	BadArgument	« returnLandmarks » n’est pas pris en charge par detection_02.
Interdit (403)	UnsupportedFeature	Les attributs retour (émotion, sexe, âge, sourire, cheveux du visage, cheveux et maquillage) ont été dépréciés et ne sont plus pris en charge.	Envoyez un e-mail à l’équipe Visage Azure si vous disposez d’un cas d’usage responsable qui tirerait parti de l’utilisation de l’une des fonctionnalités limitées.

Codes d’erreur de session Liveness Face

Ces codes d’erreur peuvent être retournés par les opérations de session Face Liveness.

Code d’état Http	Code d'erreur	Message d’erreur
Demande incorrecte (400)	BadArgument	Le paramètre de démarrage n’est pas valide. Spécifiez le champ « ID » de la dernière entrée pour poursuivre le processus de référencement.
Demande incorrecte (400)	BadArgument	Le paramètre supérieur n’est pas valide. La plage valide est comprise entre 1 et 1 000 inclus.
Demande incorrecte (400)	InvalidRequestBody	Corps de la demande incorrect fourni. Vérifiez le schéma de l’opération et réessayez.
Demande incorrecte (400)	InvalidTokenLifetime	AuthTokenTimeToLiveInSeconds non valide spécifié. Doit être compris entre 60 et 86400.
Demande incorrecte (400)	InvalidLivenessOperationMode	LivenessOperationMode non valide spécifié. Doit être « passif ».
Demande incorrecte (400)	InvalidDeviceCorrelationId	Un ID de corrélation d’appareil est requis dans le corps de la demande pendant la création de session ou le démarrage de session. Ne doit pas être null ou vide et ne doit pas dépasser 64 caractères.
Introuvable (404)	SessionNotFound	L’ID de session est introuvable. L’ID de session a expiré ou n’existe pas.

Identifier les codes d’erreur

Ces codes d’erreur peuvent être retournés par l’opération Identification de visage.

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	'recognitionModel' n’est pas compatible.
Demande incorrecte (400)	BadArgument	L’ID de groupe de personnes n’est pas valide.
Demande incorrecte (400)	BadArgument	L’ID de groupe de personnes volumineux n’est pas valide.
Demande incorrecte (400)	BadArgument	L’ID de groupe de personnes dynamiques n’est pas valide.
Demande incorrecte (400)	BadArgument	L’argument maxNumOfCandidatesReturned n’est pas valide.	La plage valide est comprise entre [1, 100].
Demande incorrecte (400)	BadArgument	L’argument confidenceThreshold n’est pas valide.	La plage valide est comprise entre [0, 1].
Demande incorrecte (400)	BadArgument	La longueur des faceIds n’est pas dans une plage valide.	La plage valide est comprise entre [1, 10].
Demande incorrecte (400)	FaceNotFound	Le visage n’est pas trouvé.
Demande incorrecte (400)	PersonGroupNotFound	Le groupe de personnes est introuvable.
Demande incorrecte (400)	LargePersonGroupNotFound	Un grand groupe de personnes est introuvable.
Demande incorrecte (400)	DynamicPersonGroupNotFound	Le groupe de personnes dynamiques est introuvable.
Demande incorrecte (400)	PersonGroupNotTrained	Groupe de personnes non formé.
Demande incorrecte (400)	LargePersonGroupNotTrained	Groupe de personnes volumineux non formé.
Demande incorrecte (400)	PersonGroupIdAndLargePersonGroupIdBothNotNull	L’ID de groupe de personnes volumineux et l’ID de groupe de personnes ne sont pas null.
Demande incorrecte (400)	PersonGroupIdAndLargePersonGroupIdBothNull	L’ID de groupe de personnes volumineux et l’ID de groupe de personnes sont tous deux null.
Demande incorrecte (400)	MissingIdentificationScopeParameters	Aucun paramètre d’étendue d’identification n’est présent dans la requête.
Demande incorrecte (400)	IncompatibleIdentificationScopeParametersCombination	Les paramètres d’étendue d’identification incompatibles sont présents dans la requête.
Conflit (409)	PersonGroupTrainingNotFinished	Le groupe de personnes est en formation.
Conflit (409)	LargePersonGroupTrainingNotFinished	Un grand groupe de personnes est en formation.

Vérification des codes d’erreur Face Verify

Ces codes d’erreur peuvent être retournés par l’opération Vérification des visages.

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	'recognitionModel' n’est pas compatible.
Demande incorrecte (400)	BadArgument	L’ID de visage n’est pas valide.	Un faceId valide provient de Face - Detect.
Demande incorrecte (400)	BadArgument	L’ID de personne n’est pas valide.	Un personId valide est généré à partir de créer une personne de groupe de personnes, créer une personne de groupe de personnes volumineuse ou un répertoire de personnes - Créer une personne.
Demande incorrecte (400)	BadArgument	L’ID de groupe de personnes n’est pas valide.
Demande incorrecte (400)	BadArgument	L’ID de groupe de personnes volumineux n’est pas valide.
Demande incorrecte (400)	PersonNotFound	La personne n’est pas trouvée.
Demande incorrecte (400)	PersonGroupNotFound	Le groupe de personnes est introuvable.
Demande incorrecte (400)	LargePersonGroupNotFound	Le groupe de personnes volumineux est introuvable.
Introuvable (404)	FaceNotFound	Le visage n’est pas trouvé.
Introuvable (404)	PersonNotFound	La personne n’est pas trouvée.
Introuvable (404)	PersistedFaceNotFound	Aucun visage persistant de la personne n’est trouvé.

Rechercher des codes d’erreur similaires

Ces codes d’erreur peuvent être retournés par l’opération Face Find Similar.

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	'recognitionModel' n’est pas compatible.
Demande incorrecte (400)	BadArgument	Le mode n’est pas valide.
Demande incorrecte (400)	BadArgument	L’ID de liste de visages n’est pas valide.
Demande incorrecte (400)	BadArgument	L’ID de liste de visages volumineux n’est pas valide.
Demande incorrecte (400)	BadArgument	LargeFaceListId, faceListId et faceIds, pas exactement l’un d’entre eux est valide.
Demande incorrecte (400)	BadArgument	LargeFaceListId, faceListId et faceIds sont tous null.
Demande incorrecte (400)	BadArgument	2 ou plus de largeFaceListId, faceListId et faceIds ne sont pas null.
Demande incorrecte (400)	BadArgument	L’argument maxNumOfCandidatesReturned n’est pas valide.	La plage valide est comprise entre [1, 1000].
Demande incorrecte (400)	BadArgument	La longueur des faceIds n’est pas dans une plage valide.	La plage valide est comprise entre [1, 1000].
Demande incorrecte (400)	FaceNotFound	Le visage n’est pas trouvé.
Demande incorrecte (400)	FaceListNotFound	La liste des visages est introuvable.
Demande incorrecte (400)	LargeFaceListNotFound	La liste des visages volumineux est introuvable.
Demande incorrecte (400)	LargeFaceListNotTrained	La liste des visages volumineux n’est pas entraînée.
Demande incorrecte (400)	FaceListNotReady	La liste des visages est vide.
Conflit (409)	LargeFaceListTrainingNotFinished	Une grande liste de visages est en cours d’entraînement.

Codes d’erreur Visage Group

Ces codes d’erreur peuvent être retournés par l’opération Face Group.

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	'recognitionModel' n’est pas compatible.
Demande incorrecte (400)	BadArgument	La longueur des faceIds n’est pas dans une plage valide.	La plage valide est comprise entre [2, 1000].

Opérations de groupe de personnes

Ces codes d’erreur peuvent être retournés par les opérations de groupe de personnes.

Codes d’erreur du groupe de personnes

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	L’ID de groupe de personnes n’est pas valide.	Le caractère valide est une lettre anglaise en minuscules, chiffres, '-' ou '_'. La longueur maximale est de 64.
Interdit (403)	QuotaExceeded	Le numéro de groupe de personnes a atteint la limite de niveau d’abonnement.
Interdit (403)	QuotaExceeded	Le nombre de personnes a atteint la limite de niveau de groupe de personnes.
Interdit (403)	QuotaExceeded	Le numéro de personne a atteint la limite de niveau d’abonnement.
Interdit (403)	QuotaExceeded	Nombre de visages persistants atteint la limite.
Introuvable (404)	PersonGroupNotFound	Le groupe de personnes est introuvable.
Introuvable (404)	PersonGroupNotFound	L’ID de groupe de personnes n’est pas valide.
Introuvable (404)	PersonNotFound	La personne `<personId>` n’est pas trouvée.
Introuvable (404)	PersonNotFound	L’ID de personne n’est pas valide.
Introuvable (404)	PersistedFaceNotFound	Le visage persistant est introuvable.
Introuvable (404)	PersistedFaceNotFound	Le visage `<faceId>` persistant est introuvable.
Introuvable (404)	PersistedFaceNotFound	L’ID de visage persistant n’est pas valide.
Introuvable (404)	PersonGroupNotTrained	Groupe de personnes non formé.	Cette erreur s’affiche sur l’obtention de l’état de formation d’un groupe qui n’a jamais été formé.
Conflit (409)	PersonGroupExists	Le groupe de personnes existe déjà.
Conflit (409)	PersonGroupTrainingNotFinished	Le groupe de personnes est en formation.	Réessayez une fois l’entraînement terminé.

Codes d’erreur de groupe de personnes volumineux

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	L’ID de groupe de personnes volumineux n’est pas valide.	Le caractère valide est une lettre anglaise en minuscules, chiffres, '-' ou '_'. La longueur maximale est de 64.
Demande incorrecte (400)	BadArgument	« name » et « userData » sont vides.
Interdit (403)	QuotaExceeded	Le nombre de groupes de personnes volumineux a atteint la limite de niveau d’abonnement.
Interdit (403)	QuotaExceeded	Le nombre de personnes a atteint une limite de niveau de groupe de personnes volumineuse.
Interdit (403)	QuotaExceeded	Le numéro de personne a atteint la limite de niveau d’abonnement.
Interdit (403)	QuotaExceeded	Nombre de visages persistants atteint la limite.
Introuvable (404)	LargePersonGroupNotFound	Un grand groupe de personnes est introuvable.
Introuvable (404)	LargePersonGroupNotFound	L’ID de groupe de personnes volumineux n’est pas valide.
Introuvable (404)	PersonNotFound	La personne `<personId>` n’est pas trouvée.
Introuvable (404)	PersonNotFound	L’ID de personne n’est pas valide.
Introuvable (404)	PersistedFaceNotFound	Le visage persistant est introuvable.
Introuvable (404)	PersistedFaceNotFound	Le visage `<faceId>` persistant est introuvable.
Introuvable (404)	PersistedFaceNotFound	L’ID de visage persistant n’est pas valide.
Introuvable (404)	LargePersonGroupNotTrained	Groupe de personnes volumineux non formé.	Cette erreur s’affiche sur l’obtention de l’état de formation d’un groupe qui n’a jamais été formé.
Conflit (409)	LargePersonGroupExists	Un grand groupe de personnes existe déjà.
Conflit (409)	LargePersonGroupTrainingNotFinished	Un grand groupe de personnes est en formation.	Réessayez une fois l’entraînement terminé.

Opérations de liste de visages

Ces codes d’erreur peuvent être retournés par les opérations De liste de visages.

Codes d’erreur de liste de visages

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	L’ID de liste de visages n’est pas valide.	Le caractère valide est une lettre anglaise en minuscules, chiffres, '-' ou '_'. La longueur maximale est de 64.
Interdit (403)	QuotaExceeded	Nombre de visages persistants atteint la limite.
Introuvable (404)	FaceListNotFound	La liste des visages est introuvable.
Introuvable (404)	FaceListNotFound	L’ID de liste de visages n’est pas valide.
Introuvable (404)	PersistedFaceNotFound	Le visage persistant est introuvable.
Introuvable (404)	PersistedFaceNotFound	L’ID de visage persistant n’est pas valide.
Conflit (409)	FaceListExists	La liste des visages existe déjà.

Codes d’erreur de liste de visages volumineux

Code d’état Http	Code d'erreur	Message d’erreur	Description
Demande incorrecte (400)	BadArgument	L’ID de liste de visages volumineux n’est pas valide.	Le caractère valide est une lettre anglaise en minuscules, chiffres, '-' ou '_'. La longueur maximale est de 64.
Demande incorrecte (400)	BadArgument	« name » et « userData » sont vides.
Interdit (403)	QuotaExceeded	Nombre de listes de visages volumineux atteint la limite.
Interdit (403)	QuotaExceeded	Nombre de visages persistants atteint la limite.
Introuvable (404)	LargeFaceListNotFound	La liste des visages volumineux est introuvable.
Introuvable (404)	LargeFaceListNotFound	L’ID de liste de visages volumineux n’est pas valide.
Introuvable (404)	PersistedFaceNotFound	Le visage `<faceId>` de la liste de visages volumineux est introuvable.
Introuvable (404)	PersistedFaceNotFound	L’ID de visage persistant n’est pas valide.
Introuvable (404)	LargeFaceListNotTrained	Liste de visages volumineux non entraînée.	Cette erreur s’affiche sur l’obtention de l’état de formation d’une liste de visages volumineuse qui n’a jamais été formée.
Conflit (409)	LargeFaceListExists	Une liste de visages volumineuses existe déjà.
Conflit (409)	LargeFaceListTrainingNotFinished	Une grande liste de visages est en cours d’entraînement.	Réessayez une fois l’entraînement terminé.

Opérations d’annuaire de personnes

Ces codes d’erreur peuvent être retournés par les opérations d’annuaire de personnes.

Codes d’erreur d’annuaire de personnes

Code d’état Http	Code d'erreur	Message d’erreur
Demande incorrecte (400)	BadArgument	Le modèle de reconnaissance n’est pas pris en charge pour cette fonctionnalité.
Demande incorrecte (400)	BadArgument	'start' n’est pas un ID de personne valide.
Demande incorrecte (400)	BadArgument	« name » et « userData » sont vides.
Demande incorrecte (400)	DynamicPersonGroupNotFound	L’ID de groupe de personnes dynamiques n’est pas valide.
Interdit (403)	QuotaExceeded	Le numéro de personne a atteint la limite de niveau d’abonnement.
Interdit (403)	QuotaExceeded	Nombre de visages persistants atteint la limite.
Introuvable (404)	DynamicPersonGroupNotFound	Le groupe de personnes dynamiques n’a pas été trouvé.
Introuvable (404)	DynamicPersonGroupNotFound	DynamicPersonGroupPersonReference `<groupId>` est introuvable.
Introuvable (404)	PersonNotFound	La personne n’est pas trouvée.
Introuvable (404)	PersonNotFound	L’ID de personne n’est pas valide.
Introuvable (404)	PersistedFaceNotFound	Le visage persistant est introuvable.
Introuvable (404)	PersistedFaceNotFound	Le visage `<faceId>` persistant est introuvable.
Introuvable (404)	PersistedFaceNotFound	L’ID visage persistant n’est pas valide.
Conflit (409)	DynamicPersonGroupExists	L’ID `<groupId>` de groupe de personnes dynamiques existe déjà.

Étapes suivantes

Référence sur l’API Visage

Partager via