Person Group Operations - Get Large Person Group Training Status

Dienst:

Azure AI Services

API-Version:

v1.2-preview.1

So überprüfen Sie den Schulungsstatus der Großen Personengruppe oder werden weiterhin ausgeführt. Die Schulung "Große Personengruppe" ist ein asynchroner Vorgang, der von der API "Train Large Person Group" ausgelöst wird.
Die Schulungszeit hängt von der Anzahl der Personeneinträge und deren Gesichter in einer großen Personengruppe ab. Es kann in Sekunden oder bis zu einer halben Stunde für 1.000.000 Personen sein.

GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/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).
largePersonGroupId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	ID des Containers.

Antworten

Name	Typ	Beschreibung
200 OK	TrainingResult	Ein erfolgreicher Anruf gibt den Schulungsstatus der Großen Personengruppe 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 LargePersonGroup

Beispielanforderung

HTTP

GET {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_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

Objekt

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

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.

OperationStatus

Enumeration

Der Status des Vorgangs mit langer Ausführung.

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

TrainingResult

Objekt

Schulungsergebnis eines Containers

Name	Typ	Beschreibung
createdDateTime	string (date-time)	Eine kombinierte UTC-Datums- und Uhrzeitzeichenfolge, die die erstellungszeit der Personengruppe, der großen Personengruppe oder der großen Gesichtsliste beschreibt.
lastActionDateTime	string (date-time)	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 (date-time)	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.