Freigeben über


Face List Operations - Get Large Face List Training Status

Um das Training für große Gesichtserkennungslisten zu überprüfen, status abgeschlossen oder noch ausgeführt. Das Training für große Gesichtslisten ist ein asynchroner Vorgang, der durch "Train Large Face List" ausgelöst wird.

Die Trainingszeit hängt von der Anzahl der Gesichtseinträge in einer großen Gesichtsliste ab. Es kann in Sekunden oder bis zu einer halben Stunde für 1.000.000 Gesichter sein.

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/training

URI-Parameter

Name In Erforderlich Typ Beschreibung
apiVersion
path True

string

API-Version

endpoint
path True

string

uri

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com).

largeFaceListId
path True

string

Gültiges Zeichen ist Der Buchstabe in Kleinbuchstaben oder Ziffern oder "-" oder "_", die maximale Länge beträgt 64.

RegEx-Muster: ^[a-z0-9-_]+$

Antworten

Name Typ Beschreibung
200 OK

TrainingResult

Ein erfolgreicher Aufruf gibt die Trainings-status der großen Gesichtserkennungsliste zurück.

Other Status Codes

FaceErrorResponse

Eine unerwartete Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure KI-Gesichtserkennungsabonnement.

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Flow

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiche

Name Beschreibung
https://cognitiveservices.azure.com/.default

Beispiele

Get Training Status of LargeFaceList

Beispielanforderung

GET {endpoint}/face/v1.1-preview.1/largefacelists/your_large_face_list_id/training

Beispiel für eine Antwort

{
  "status": "notStarted",
  "createdDateTime": "2024-03-05T11:07:58.371Z",
  "lastActionDateTime": "2024-03-05T11:07:58.371Z",
  "lastSuccessfulTrainingDateTime": "2024-03-05T11:07:58.371Z",
  "message": null
}

Definitionen

Name Beschreibung
FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Meldungen, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

OperationStatus

Die status des zeitintensiven Vorgangs.

TrainingResult

Trainingsergebnis eines Containers

FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Meldungen, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

Name Typ Beschreibung
code

string

Einer von einem serverdefiniertem Satz von Fehlercodes.

message

string

Eine lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name Typ Beschreibung
error

FaceError

Das Fehlerobjekt.

OperationStatus

Die status des zeitintensiven Vorgangs.

Name Typ Beschreibung
failed

string

Der Vorgang ist fehlgeschlagen.

notStarted

string

Der Vorgang wird nicht gestartet.

running

string

Der Vorgang wird weiterhin ausgeführt.

succeeded

string

Der Vorgang ist erfolgreich.

TrainingResult

Trainingsergebnis eines Containers

Name Typ Beschreibung
createdDateTime

string

Eine kombinierte UTC-Datums- und Uhrzeitzeichenfolge, die die Erstellungszeit der Personengruppe, einer großen Personengruppe oder einer großen Gesichtsliste beschreibt.

lastActionDateTime

string

Eine kombinierte UTC-Datums- und Uhrzeitzeichenfolge, die den Zeitpunkt der letzten Änderung der Personengruppe, der großen Personengruppe oder der großen Gesichtsliste beschreibt, kann NULL-Wert sein, wenn die Gruppe nicht erfolgreich trainiert wurde.

lastSuccessfulTrainingDateTime

string

Eine kombinierte UTC-Datums- und Uhrzeitzeichenfolge, die die letzte erfolgreiche Trainingszeit der Personengruppe, der großen Personengruppe oder der großen Gesichtsliste beschreibt.

message

string

Fehlermeldung anzeigen, wenn das Training fehlgeschlagen ist (ausgelassen, wenn das Training erfolgreich war).

status

OperationStatus

Training status des Containers.