Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Häufige Fehlermeldungen
Diese Fehlercodes können von allen Face-API-Aufrufen zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Der Anforderungstext ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | JSON-Analysefehler. | Ungültiger oder nicht erkennbarer JSON-Anforderungstext. |
| Ungültige Anforderung (400) | BadArgument | „recognitionModel“ ist falsch. | |
| Ungültige Anforderung (400) | BadArgument | „detectionModel“ ist falsch. | |
| Ungültige Anforderung (400) | BadArgument | "Name" ist leer. | |
| Ungültige Anforderung (400) | BadArgument | "Name" ist zu lang. | |
| Ungültige Anforderung (400) | BadArgument | "userData" ist zu lang. | |
| Ungültige Anforderung (400) | BadArgument | "Start" ist zu lang. | |
| Ungültige Anforderung (400) | BadArgument | "top" ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Argument targetFace außerhalb des Bereichs. | |
| Ungültige Anforderung (400) | BadArgument | Ungültiges Argument targetFace. | Wird durch ein ungültiges Zeichenfolgenformat oder einen ungültigen Wert für links/oben/höhe/breite verursacht. |
| Ungültige Anforderung (400) | InvalidURL | Ungültige Bild-URL. | Als Formate werden JPEG, PNG, GIF (der erste Frame) und BMP unterstützt. |
| Ungültige Anforderung (400) | InvalidURL | Ungültige Bild-URL oder Fehler beim Herunterladen vom Zielserver. Remoteserverfehler zurückgegeben: "Fehler beim Senden der Anforderung." | |
| Ungültige Anforderung (400) | InvalidImage | Decodierungsfehler, Bildformat nicht unterstützt. | |
| Ungültige Anforderung (400) | InvalidImage | Im Bild wurde kein Gesicht erkannt. | |
| Ungültige Anforderung (400) | InvalidImage | Es gibt mehr als 1 Gesicht im Bild. | |
| Ungültige Anforderung (400) | InvalidImageSize | Die Bildgröße ist zu klein. | Die gültige Bilddatei sollte größer oder gleich 1 KB sein. |
| Ungültige Anforderung (400) | InvalidImageSize | Die Bildgröße ist zu groß. | Die gültige Bilddatei sollte nicht größer als 6 MB sein. |
| Nicht autorisiert (401) | 401 | Der Zugriff wurde aufgrund eines ungültigen Abonnementschlüssels oder eines falschen API-Endpunkts verweigert. Stellen Sie sicher, dass Sie einen gültigen Schlüssel für ein aktives Abonnement bereitstellen und einen richtigen regionalen API-Endpunkt für Ihre Ressource verwenden. | |
| Unzulässig (403) | UnsupportedFeature | Das Feature wird nicht unterstützt, fehlende Genehmigung für eine oder mehrere der folgenden Features: Identifikation, Überprüfung. | Registrieren Sie sich für den Zugriff, indem Sie ein Registrierungsformular übermitteln. |
| Konflikt (409) | ConcurrentOperationConflict | Es ist ein Konfliktvorgang für die Ressource <resourceName>vorhanden. Versuchen Sie es bitte später. |
|
| Zu viele Anforderungen (429) | 429 | Die Durchsatzgrenze wurde überschritten. |
Fehlercodes für die Gesichtserkennung
Diese Fehlercodes können vom Gesichtserkennungsvorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Ungültiges Argument returnFaceAttributes. | |
| Ungültige Anforderung (400) | BadArgument | „returnFaceAttributes“ wird von detection_02 nicht unterstützt. | |
| Ungültige Anforderung (400) | BadArgument | „returnLandmarks“ wird von detection_02 nicht unterstützt. | |
| Unzulässig (403) | UnsupportedFeature | Rückgabeattribute (Emotion, Geschlecht, Alter, Lächeln, Gesichtshaare, Haar und Make-up) sind veraltet und werden nicht mehr unterstützt. | Senden Sie eine E-Mail an das Team für die Azure-Gesichtserkennung, wenn Sie einen verantwortungsvollen Anwendungsfall haben, der von der Verwendung einer der eingeschränkten Funktionen profitieren würde. |
Fehlercodes für Die Livenesssitzung
Diese Fehlercodes können von Face Liveness Session-Vorgängen zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Der Startparameter ist ungültig. Geben Sie das Feld "ID" des letzten Eintrags an, um den Eintragsvorgang fortzusetzen. | |
| Ungültige Anforderung (400) | BadArgument | Der top-Parameter ist ungültig. Gültiger Bereich liegt zwischen 1 und 1000 einschließlich. | |
| Ungültige Anforderung (400) | InvalidRequestBody | Falscher Anforderungstext angegeben. Überprüfen Sie das Vorgangsschema, und versuchen Sie es erneut. | |
| Ungültige Anforderung (400) | InvalidTokenLifetime | Ungültige authTokenTimeToLiveInSeconds angegeben. Muss innerhalb von 60 bis 86400 sein. | |
| Ungültige Anforderung (400) | InvalidLivenessOperationMode | Ungültiger livenessOperationMode-Wert. Muss "Passiv" sein. | |
| Ungültige Anforderung (400) | InvalidDeviceCorrelationId | Eine Gerätekorrelations-ID ist im Anforderungstext während der Sitzungserstellung oder sitzungsanfang erforderlich. Darf nicht null oder leer sein und darf nicht mehr als 64 Zeichen lang sein. | |
| Nicht gefunden (404) | SessionNotFound | Die Sitzungs-ID wurde nicht gefunden. Die Sitzungs-ID ist abgelaufen oder ist nicht vorhanden. |
Fehlercodes für die Gesichts-Identifizierung
Diese Fehlercodes können vom Face Identify-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Die Personengruppen-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die Gruppen-ID für große Personen ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Dynamische Personengruppen-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Das Argument maxNumOfCandidatesReturned ist ungültig. | Der gültige Bereich liegt zwischen [1, 100]. |
| Ungültige Anforderung (400) | BadArgument | Das Argument confidenceThreshold ist ungültig. | Der gültige Bereich liegt zwischen [0, 1]. |
| Ungültige Anforderung (400) | BadArgument | Die Länge von faceIds befindet sich nicht in einem gültigen Bereich. | Der gültige Bereich liegt zwischen [1, 10]. |
| Ungültige Anforderung (400) | FaceNotFound | Das Gesicht wurde nicht gefunden. | |
| Ungültige Anforderung (400) | PersonGroupNotFound | Die Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargePersonGroupNotFound | Große Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | DynamicPersonGroupNotFound | Dynamische Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | PersonGroupNotTrained | Personengruppe nicht trainiert. | |
| Ungültige Anforderung (400) | LargePersonGroupNotTrained | Große Personengruppe wurde nicht trainiert. | |
| Ungültige Anforderung (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | Die Gruppen-ID für große Personen und die Gruppen-ID für große Personen sind nicht null. | |
| Ungültige Anforderung (400) | PersonGroupIdAndLargePersonGroupIdBothNull | Die Gruppen-ID für große Personen und die Gruppen-ID für große Personen sind beide NULL. | |
| Ungültige Anforderung (400) | MissingIdentificationScopeParameters | In der Anforderung ist kein Identifikationsbereichsparameter vorhanden. | |
| Ungültige Anforderung (400) | InkompatibleIdentificationScopeParametersCombination | Inkompatible Identifikationsbereichsparameter sind in der Anforderung vorhanden. | |
| Konflikt (409) | PersonGroupTrainingNotFinished | Die Personengruppe befindet sich in der Ausbildung. | |
| Konflikt (409) | LargePersonGroupTrainingNotFinished | Große Personengruppe befindet sich im Training. |
Fehlercodes für die Gesichtsüberprüfung
Diese Fehlercodes können vom Face Verify-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Die Gesichts-ID ist ungültig. | Eine gültige FaceId stammt von Face - Detect. |
| Ungültige Anforderung (400) | BadArgument | Die Personen-ID ist ungültig. | Eine gültige personId wird aus "Person-Gruppenperson erstellen", "Person erstellen" oder "Person verzeichnis erstellen" generiert. |
| Ungültige Anforderung (400) | BadArgument | Die Personengruppen-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die Gruppen-ID für große Personen ist ungültig. | |
| Ungültige Anforderung (400) | PersonNotFound | Die Person wurde nicht gefunden. | |
| Ungültige Anforderung (400) | PersonGroupNotFound | Die Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargePersonGroupNotFound | Große Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | FaceNotFound | Das Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersonNotFound | Die Person wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Es wurde kein permanentes Gesicht der Person gefunden. |
Ähnliche Fehlercodes suchen
Diese Fehlercodes können durch den Face Find Similar-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Der Modus ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die Gesichtslisten-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die ID für große Gesichtslisten ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | LargeFaceListId, faceListId und faceIds, nicht genau einer davon ist gültig. | |
| Ungültige Anforderung (400) | BadArgument | LargeFaceListId, faceListId und faceIds sind alle null. | |
| Ungültige Anforderung (400) | BadArgument | 2 oder mehr von largeFaceListId, faceListId und faceIds sind nicht NULL. | |
| Ungültige Anforderung (400) | BadArgument | Das Argument maxNumOfCandidatesReturned ist ungültig. | Der gültige Bereich liegt zwischen [1, 1000]. |
| Ungültige Anforderung (400) | BadArgument | Die Länge von faceIds befindet sich nicht in einem gültigen Bereich. | Der gültige Bereich liegt zwischen [1, 1000]. |
| Ungültige Anforderung (400) | FaceNotFound | Das Gesicht wurde nicht gefunden. | |
| Ungültige Anforderung (400) | FaceListNotFound | Die Gesichtsliste wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargeFaceListNotFound | Große Gesichtsliste wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargeFaceListNotTrained | Große Gesichtsliste ist nicht trainiert. | |
| Ungültige Anforderung (400) | FaceListNotReady | Die Gesichtsliste ist leer. | |
| Konflikt (409) | LargeFaceListTrainingNotFinished | Die große Gesichtsliste befindet sich in der Schulung. |
Fehlercodes für Die Gesichtsgruppe
Diese Fehlercodes können vom Face Group-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Die Länge von faceIds befindet sich nicht in einem gültigen Bereich. | Der gültige Bereich liegt zwischen [2, 1000]. |
Personengruppenvorgänge
Diese Fehlercodes können von Personengruppenvorgängen zurückgegeben werden.
Fehlercodes für Personengruppen
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die Personengruppen-ID ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Unzulässig (403) | QuotaExceeded | Die Anzahl der Personengruppen hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Personengruppenebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | PersonGroupNotFound | Die Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | PersonGroupNotFound | Die Personengruppen-ID ist ungültig. | |
| Nicht gefunden (404) | PersonNotFound | Die Person <personId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersonNotFound | Die Personen-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht <faceId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Nicht gefunden (404) | PersonGroupNotTrained | Personengruppe nicht trainiert. | Dieser Fehler tritt auf, um den Schulungsstatus einer Gruppe zu erhalten, die nie trainiert wurde. |
| Konflikt (409) | PersonGroupExists | Personengruppe ist bereits vorhanden. | |
| Konflikt (409) | PersonGroupTrainingNotFinished | Die Personengruppe befindet sich in der Ausbildung. | Versuchen Sie es nach Abschluss der Schulung erneut. |
Fehlercodes für große Personengruppe
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die Gruppen-ID für große Personen ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Ungültige Anforderung (400) | BadArgument | Sowohl 'name' als auch 'userData' sind leer. | |
| Unzulässig (403) | QuotaExceeded | Die Anzahl der großen Personengruppen hat das Limit auf Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personenzahl hat den Grenzwert für große Personengruppen erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | LargePersonGroupNotFound | Große Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | LargePersonGroupNotFound | Die Gruppen-ID für große Personen ist ungültig. | |
| Nicht gefunden (404) | PersonNotFound | Die Person <personId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersonNotFound | Die Personen-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht <faceId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Nicht gefunden (404) | LargePersonGroupNotTrained | Große Personengruppe wurde nicht trainiert. | Dieser Fehler tritt auf, um den Schulungsstatus einer Gruppe zu erhalten, die nie trainiert wurde. |
| Konflikt (409) | LargePersonGroupExists | Große Personengruppe ist bereits vorhanden. | |
| Konflikt (409) | LargePersonGroupTrainingNotFinished | Große Personengruppe befindet sich im Training. | Versuchen Sie es nach Abschluss der Schulung erneut. |
Face List-Vorgänge
Diese Fehlercodes können von Face List-Vorgängen zurückgegeben werden.
Fehlercodes für Die Gesichtsliste
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die Gesichtslisten-ID ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | FaceListNotFound | Die Gesichtsliste wurde nicht gefunden. | |
| Nicht gefunden (404) | FaceListNotFound | Die Gesichtslisten-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Konflikt (409) | FaceListExists | Die Gesichtsliste ist bereits vorhanden. |
Fehlercodes für große Gesichtsliste
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die ID für große Gesichtslisten ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Ungültige Anforderung (400) | BadArgument | Sowohl 'name' als auch 'userData' sind leer. | |
| Unzulässig (403) | QuotaExceeded | Die Anzahl der großen Gesichtslisten wurde erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | LargeFaceListNotFound | Große Gesichtsliste wurde nicht gefunden. | |
| Nicht gefunden (404) | LargeFaceListNotFound | Die ID für große Gesichtslisten ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das face list large face <faceId> is not found. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Nicht gefunden (404) | LargeFaceListNotTrained | Große Gesichtsliste nicht trainiert. | Dieser Fehler tritt auf, um den Schulungsstatus einer großen Gesichtsliste zu erhalten, die nie trainiert wurde. |
| Konflikt (409) | LargeFaceListExists | Es ist bereits eine große Gesichtsliste vorhanden. | |
| Konflikt (409) | LargeFaceListTrainingNotFinished | Die große Gesichtsliste befindet sich in der Schulung. | Versuchen Sie es nach Abschluss der Schulung erneut. |
Personenverzeichnisvorgänge
Diese Fehlercodes können von Personenverzeichnisvorgängen zurückgegeben werden.
Fehlercodes für das Personenverzeichnis
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Das Erkennungsmodell wird für dieses Feature nicht unterstützt. | |
| Ungültige Anforderung (400) | BadArgument | "start" ist keine gültige Personen-ID. | |
| Ungültige Anforderung (400) | BadArgument | Sowohl 'name' als auch 'userData' sind leer. | |
| Ungültige Anforderung (400) | DynamicPersonGroupNotFound | Dynamische Personengruppen-ID ist ungültig. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | DynamicPersonGroupNotFound | Dynamische Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | DynamicPersonGroupNotFound | DynamicPersonGroupPersonReference <groupId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersonNotFound | Die Person wurde nicht gefunden. | |
| Nicht gefunden (404) | PersonNotFound | Die Personen-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht <faceId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Konflikt (409) | DynamicPersonGroupExists | Dynamische Personengruppen-ID <groupId> ist bereits vorhanden. |
Nächste Schritte