Face List Operations - Get Large Face List Training Status

Dienst:

Azure AI Services

API-Version:

v1.2-preview.1

So überprüfen Sie den Schulungsstatus "Große Gesichtsliste" oder "Fortlaufend". Die Schulung "Große Gesichtsliste" ist ein asynchroner Vorgang, der durch "Train Large Face List" ausgelöst wird.

Die Schulungszeit hängt von der Anzahl der Face-Einträ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 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 den Schulungsstatus der Großen Gesichtsliste zurück.
Other Status Codes	FaceErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Fluss

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

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "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 Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Eine Antwort, die Fehlerdetails enthält.
OperationStatus	Der Status des Vorgangs mit langer Ausführung.
TrainingResult	Schulungsergebnis eines Containers

FaceError

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

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
message	string	Eine lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.

OperationStatus

Der Status des Vorgangs mit langer Ausführung.

Name	Typ	Beschreibung
failed	string	Fehler beim Vorgang.
notStarted	string	Der Vorgang wird nicht gestartet.
running	string	Der Vorgang wird weiterhin ausgeführt.
succeeded	string	Der Vorgang ist erfolgreich.

TrainingResult

Schulungsergebnis eines Containers

Name	Typ	Beschreibung
createdDateTime	string	Eine kombinierte UTC-Datums- und Uhrzeitzeichenfolge, die die erstellungszeit der Personengruppe, der großen Personengruppe oder der großen Gesichtsliste beschreibt.
lastActionDateTime	string	Eine kombinierte UTC-Datums- und Uhrzeitzeichenfolge, die die letzte Änderungszeit 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 Schulungszeit der Personengruppe, der großen Personengruppe oder der großen Gesichtsliste beschreibt.
message	string	Fehlermeldung anzeigen, wenn die Schulung fehlgeschlagen ist (beim Erfolgreichen Training nicht angegeben).
status	OperationStatus	Schulungsstatus des Containers.