Delen via

Foutcodes voor Azure Face-API

Veelvoorkomende foutcodes

Deze foutcodes kunnen worden geretourneerd door alle Face-API-aanroepen.

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument Aanvraagbody is ongeldig.
Foute aanvraag (400) BadArgument JSON-parseringsfout. Ongeldige of onherkenbare aanvraag-JSON-hoofdtekst.
Foute aanvraag (400) BadArgument 'recognitionModel' is ongeldig.
Foute aanvraag (400) BadArgument 'detectionModel' is ongeldig.
Foute aanvraag (400) BadArgument 'naam' is leeg.
Foute aanvraag (400) BadArgument 'naam' is te lang.
Foute aanvraag (400) BadArgument 'userData' is te lang.
Foute aanvraag (400) BadArgument 'start' is te lang.
Foute aanvraag (400) BadArgument 'top' is ongeldig.
Foute aanvraag (400) BadArgument Argument targetFace buiten het bereik.
Foute aanvraag (400) BadArgument Ongeldig argument targetFace. Veroorzaakt door ongeldige tekenreeksindeling of ongeldige waarde voor links/hoogste/hoogte/breedte.
Foute aanvraag (400) InvalidURL Ongeldige afbeeldings-URL. Ondersteunde indelingen zijn JPEG, PNG, GIF (het eerste frame) en BMP.
Foute aanvraag (400) InvalidURL Ongeldige afbeeldings-URL of fout bij het downloaden van de doelserver. Fout bij externe server geretourneerd: 'Er is een fout opgetreden tijdens het verzenden van de aanvraag'.
Foute aanvraag (400) InvalidImage Decoderingsfout, afbeeldingsindeling wordt niet ondersteund.
Foute aanvraag (400) InvalidImage Er is geen gezicht gedetecteerd in de afbeelding.
Foute aanvraag (400) InvalidImage Er is meer dan 1 gezicht in de afbeelding.
Foute aanvraag (400) InvalidImageSize Het formaat van de afbeelding is te klein. De geldige grootte van het afbeeldingsbestand moet groter zijn dan of gelijk zijn aan 1 kB.
Foute aanvraag (400) InvalidImageSize Het formaat van de afbeelding is te groot. De geldige grootte van het afbeeldingsbestand mag niet groter zijn dan 6 MB.
Niet-gemachtigd (401) 401 Toegang geweigerd vanwege een ongeldige abonnementssleutel of een onjuist API-eindpunt. Zorg ervoor dat u een geldige sleutel voor een actief abonnement opgeeft en gebruik een correct regionaal API-eindpunt voor uw resource.
Verboden (403) UnsupportedFeature De functie wordt niet ondersteund, er ontbreekt goedkeuring voor een of meer van de volgende functies: Identificatie, Verificatie. Registreer u voor toegang door een registratieformulier in te dienen.
Conflict (409) ConcurrentOperationConflict Er is een conflictbewerking op de resource <resourceName>. Probeer het later opnieuw.
Te veel aanvragen (429) 429 De limiet wordt overschreden.

Foutcodes voor gezichtsdetectie

Deze foutcodes kunnen worden geretourneerd door de bewerking Gezichtsdetectie.

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument Ongeldig argument returnFaceAttributes.
Foute aanvraag (400) BadArgument 'returnFaceAttributes' wordt niet ondersteund door detection_02.
Foute aanvraag (400) BadArgument 'returnLandmarks' wordt niet ondersteund door detection_02.
Verboden (403) UnsupportedFeature Retourkenmerken (emotie, geslacht, leeftijd, glimlach, gezichtshaar, haar en make-up) zijn afgeschaft en worden niet meer ondersteund. Stuur een e-mail naar het Azure Face-team als u een verantwoorde use case hebt die zou profiteren van het gebruik van een van de beperkte mogelijkheden.

Foutcodes voor Face Liveness Session

Deze foutcodes kunnen worden geretourneerd door face liveness session-bewerkingen.

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument De beginparameter is ongeldig. Geef het veld Id van het laatste item op om door te gaan met het vermeldingsproces.
Foute aanvraag (400) BadArgument De bovenste parameter is ongeldig. Geldig bereik is tussen 1 en 1000 inclusief.
Foute aanvraag (400) InvalidRequestBody Onjuiste aanvraagbody opgegeven. Controleer het bewerkingsschema en probeer het opnieuw.
Foute aanvraag (400) InvalidTokenLifetime Ongeldige authTokenTimeToLiveInSeconds opgegeven. Moet binnen 60 tot 86400 zijn.
Foute aanvraag (400) InvalidLivenessOperationMode Ongeldige livenessOperationMode opgegeven. Moet passief zijn.
Foute aanvraag (400) InvalidDeviceCorrelationId Een correlatie-id van het apparaat is vereist in de hoofdtekst van de aanvraag tijdens het maken of starten van de sessie. Mag niet null of leeg zijn en mag niet langer zijn dan 64 tekens.
Niet gevonden (404) SessieNietGevonden De sessie-id is niet gevonden. De sessie-id is verlopen of bestaat niet.

Foutcodes voor gezichts identificeren

Deze foutcodes kunnen worden geretourneerd door de bewerking Face Identify.

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument 'recognitionModel' is niet compatibel.
Foute aanvraag (400) BadArgument Groeps-id van persoon is ongeldig.
Foute aanvraag (400) BadArgument Groeps-id voor grote personen is ongeldig.
Foute aanvraag (400) BadArgument De groeps-id van dynamische persoon is ongeldig.
Foute aanvraag (400) BadArgument Het argument maxNumOfCandidatesReturned is ongeldig. Het geldige bereik ligt tussen [1, 100].
Foute aanvraag (400) BadArgument Het argument confidenceThreshold is ongeldig. Het geldige bereik ligt tussen [0, 1].
Foute aanvraag (400) BadArgument De lengte van faceIds bevindt zich niet in een geldig bereik. Het geldige bereik ligt tussen [1, 10].
Foute aanvraag (400) FaceNotFound Gezicht is niet gevonden.
Foute aanvraag (400) PersonGroupNotFound De persoonsgroep is niet gevonden.
Foute aanvraag (400) LargePersonGroupNotFound Grote persoonsgroep is niet gevonden.
Foute aanvraag (400) DynamicPersonGroupNotFound Dynamische persoonsgroep is niet gevonden.
Foute aanvraag (400) PersonGroupNotTrained Persoonsgroep is niet getraind.
Foute aanvraag (400) LargePersonGroupNotTrained Grote personengroep is niet getraind.
Foute aanvraag (400) PersonGroupIdAndLargePersonGroupIdBothNotNull Groeps-id voor grote personen en groeps-id's voor personen zijn beide niet null.
Foute aanvraag (400) PersonGroupIdAndLargePersonGroupIdBothNull Groeps-id voor grote personen en groeps-id's voor personen zijn beide null.
Foute aanvraag (400) MissingIdentificationScopeParameters Er is geen parameter voor het identificatiebereik aanwezig in de aanvraag.
Foute aanvraag (400) IncompatibleIdentificationScopeParametersCombination Incompatibele parameters voor het identificatiebereik zijn aanwezig in de aanvraag.
Conflict (409) PersonGroupTrainingNotFinished De persoonsgroep wordt getraind.
Conflict (409) LargePersonGroupTrainingNotFinished Grote personengroep wordt getraind.

Foutcodes voor gezichtsverificatie

Deze foutcodes kunnen worden geretourneerd door de bewerking Face Verify.

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument 'recognitionModel' is niet compatibel.
Foute aanvraag (400) BadArgument Face ID is ongeldig. Een geldige faceId is afkomstig van Face - Detect.
Foute aanvraag (400) BadArgument De persoons-id is ongeldig. Er wordt een geldige personId gegenereerd op basis van Persoonsgroep maken, Groepslid voor grote personen of personenlijst maken - Persoon maken.
Foute aanvraag (400) BadArgument Groeps-id van persoon is ongeldig.
Foute aanvraag (400) BadArgument Groeps-id voor grote personen is ongeldig.
Foute aanvraag (400) PersonNotFound De persoon is niet gevonden.
Foute aanvraag (400) PersonGroupNotFound Persoonsgroep is niet gevonden.
Foute aanvraag (400) LargePersonGroupNotFound Large Person Group is niet gevonden.
Niet gevonden (404) FaceNotFound Gezicht is niet gevonden.
Niet gevonden (404) PersonNotFound De persoon is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Er is geen persistent gezicht van de persoon gevonden.

Vergelijkbare foutcodes zoeken

Deze foutcodes kunnen worden geretourneerd door de bewerking Face Find Similar.

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument 'recognitionModel' is niet compatibel.
Foute aanvraag (400) BadArgument De modus is ongeldig.
Foute aanvraag (400) BadArgument Gezichtslijst-id is ongeldig.
Foute aanvraag (400) BadArgument De id van de lijst met grote gezichten is ongeldig.
Foute aanvraag (400) BadArgument LargeFaceListId, faceListId en faceIds, niet precies een van deze is geldig.
Foute aanvraag (400) BadArgument LargeFaceListId, faceListId en faceIds zijn allemaal null.
Foute aanvraag (400) BadArgument 2 of meer largeFaceListId, faceListId en faceIds zijn niet null.
Foute aanvraag (400) BadArgument Het argument maxNumOfCandidatesReturned is ongeldig. Het geldige bereik ligt tussen [1, 1000].
Foute aanvraag (400) BadArgument De lengte van faceIds bevindt zich niet in een geldig bereik. Het geldige bereik ligt tussen [1, 1000].
Foute aanvraag (400) FaceNotFound Gezicht is niet gevonden.
Foute aanvraag (400) FaceListNotFound Gezichtslijst is niet gevonden.
Foute aanvraag (400) LargeFaceListNotFound De lijst met grote gezichten is niet gevonden.
Foute aanvraag (400) LargeFaceListNotTrained Grote gezichtslijst is niet getraind.
Foute aanvraag (400) FaceListNotReady De gezichtslijst is leeg.
Conflict (409) LargeFaceListTrainingNotFinished Grote gezichtslijst staat onder training.

Foutcodes voor gezichtsgroep

Deze foutcodes kunnen worden geretourneerd door de bewerking Face Group.

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument 'recognitionModel' is niet compatibel.
Foute aanvraag (400) BadArgument De lengte van faceIds bevindt zich niet in een geldig bereik. Het geldige bereik ligt tussen [2, 1000].

Bewerkingen van personengroep

Deze foutcodes kunnen worden geretourneerd door bewerkingen van de persoonsgroep.

Foutcodes voor personengroep

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument Groeps-id van persoon is ongeldig. Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64.
Verboden (403) QuotaExceeded Het groepsnummer van de persoon heeft de limiet voor abonnementsniveau bereikt.
Verboden (403) QuotaExceeded Het persoonsnummer heeft de limiet voor groepsniveau voor personen bereikt.
Verboden (403) QuotaExceeded Persoonsnummer heeft de limiet voor abonnementsniveau bereikt.
Verboden (403) QuotaExceeded Het permanente gezichtsnummer heeft de limiet bereikt.
Niet gevonden (404) PersonGroupNotFound De persoonsgroep is niet gevonden.
Niet gevonden (404) PersonGroupNotFound Groeps-id van persoon is ongeldig.
Niet gevonden (404) PersonNotFound De persoon <personId> is niet gevonden.
Niet gevonden (404) PersonNotFound De persoons-id is ongeldig.
Niet gevonden (404) PersistentedFaceNotFound Persistent gezicht is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistent gezicht <faceId> is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistente gezichts-id is ongeldig.
Niet gevonden (404) PersonGroupNotTrained Persoonsgroep is niet getraind. Deze fout wordt weergegeven bij het ophalen van de trainingsstatus van een groep die nooit is getraind.
Conflict (409) PersonGroupExists Persoonsgroep bestaat al.
Conflict (409) PersonGroupTrainingNotFinished De persoonsgroep wordt getraind. Probeer het opnieuw nadat de training is voltooid.

Foutcodes voor grote personengroep

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument Groeps-id voor grote personen is ongeldig. Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64.
Foute aanvraag (400) BadArgument Zowel 'name' als 'userData' zijn leeg.
Verboden (403) QuotaExceeded Het groepsnummer voor grote personen bereikt de limiet op abonnementsniveau.
Verboden (403) QuotaExceeded Het aantal personen bereikt limiet op groepsniveau voor grote personen.
Verboden (403) QuotaExceeded Persoonsnummer heeft de limiet voor abonnementsniveau bereikt.
Verboden (403) QuotaExceeded Het permanente gezichtsnummer heeft de limiet bereikt.
Niet gevonden (404) LargePersonGroupNotFound Grote persoonsgroep is niet gevonden.
Niet gevonden (404) LargePersonGroupNotFound Groeps-id voor grote personen is ongeldig.
Niet gevonden (404) PersonNotFound De persoon <personId> is niet gevonden.
Niet gevonden (404) PersonNotFound De persoons-id is ongeldig.
Niet gevonden (404) PersistentedFaceNotFound Persistent gezicht is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistent gezicht <faceId> is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistente gezichts-id is ongeldig.
Niet gevonden (404) LargePersonGroupNotTrained Grote personengroep is niet getraind. Deze fout wordt weergegeven bij het ophalen van de trainingsstatus van een groep die nooit is getraind.
Conflict (409) LargePersonGroupExists Groep grote personen bestaat al.
Conflict (409) LargePersonGroupTrainingNotFinished Grote personengroep wordt getraind. Probeer het opnieuw nadat de training is voltooid.

Bewerkingen voor gezichtslijst

Deze foutcodes kunnen worden geretourneerd door gezichtslijstbewerkingen.

Foutcodes voor Gezichtslijst

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument Gezichtslijst-id is ongeldig. Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64.
Verboden (403) QuotaExceeded Het permanente gezichtsnummer heeft de limiet bereikt.
Niet gevonden (404) FaceListNotFound Gezichtslijst is niet gevonden.
Niet gevonden (404) FaceListNotFound Gezichtslijst-id is ongeldig.
Niet gevonden (404) PersistentedFaceNotFound Persistent gezicht is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistente gezichts-id is ongeldig.
Conflict (409) FaceListExists De gezichtslijst bestaat al.

Foutcodes voor grote gezichtslijst

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument De id van de lijst met grote gezichten is ongeldig. Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64.
Foute aanvraag (400) BadArgument Zowel 'name' als 'userData' zijn leeg.
Verboden (403) QuotaExceeded Het nummer van de grote gezichtslijst is bereikt.
Verboden (403) QuotaExceeded Het permanente gezichtsnummer heeft de limiet bereikt.
Niet gevonden (404) LargeFaceListNotFound De lijst met grote gezichten is niet gevonden.
Niet gevonden (404) LargeFaceListNotFound De id van de lijst met grote gezichten is ongeldig.
Niet gevonden (404) PersistentedFaceNotFound Large Face List Face <faceId> is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistente gezichts-id is ongeldig.
Niet gevonden (404) LargeFaceListNotTrained Grote gezichtslijst is niet getraind. Deze fout wordt weergegeven bij het ophalen van de trainingsstatus van een grote gezichtslijst die nooit is getraind.
Conflict (409) LargeFaceListExists Er bestaat al een grote gezichtslijst.
Conflict (409) LargeFaceListTrainingNotFinished Grote gezichtslijst staat onder training. Probeer het opnieuw nadat de training is voltooid.

Bewerkingen van personendirectory

Deze foutcodes kunnen worden geretourneerd door Person Directory-bewerkingen.

Foutcodes voor persoonsmap

Http-statuscode Foutcode Foutmelding Beschrijving
Foute aanvraag (400) BadArgument Het herkenningsmodel wordt niet ondersteund voor deze functie.
Foute aanvraag (400) BadArgument 'start' is geen geldige persoons-id.
Foute aanvraag (400) BadArgument Zowel 'name' als 'userData' zijn leeg.
Foute aanvraag (400) DynamicPersonGroupNotFound De groeps-id van dynamische persoon is ongeldig.
Verboden (403) QuotaExceeded Persoonsnummer heeft de limiet voor abonnementsniveau bereikt.
Verboden (403) QuotaExceeded Het permanente gezichtsnummer heeft de limiet bereikt.
Niet gevonden (404) DynamicPersonGroupNotFound Er is geen dynamische persoonsgroep gevonden.
Niet gevonden (404) DynamicPersonGroupNotFound DynamicPersonGroupPersonReference <groupId> is niet gevonden.
Niet gevonden (404) PersonNotFound De persoon is niet gevonden.
Niet gevonden (404) PersonNotFound De persoons-id is ongeldig.
Niet gevonden (404) PersistentedFaceNotFound Persistent gezicht is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistent gezicht <faceId> is niet gevonden.
Niet gevonden (404) PersistentedFaceNotFound Persistente Face ID is ongeldig.
Conflict (409) DynamicPersonGroupExists De groeps-id <groupId> van dynamische persoon bestaat al.

Volgende stappen 

  • Last updated on