Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. | Adressez un e-mail à l’équipe Azure Visage si vous avez un cas d’usage responsable qui tirerait parti de l’utilisation des capacité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 | Description |
|---|---|---|---|
| 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 | Description |
|---|---|---|---|
| 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