Person Group Operations - Get Large Person Group Training Status
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
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
api
|
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). |
large
|
path | True |
string |
ID des Containers. RegEx-Muster: |
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Ein erfolgreicher Anruf gibt den Schulungsstatus der Großen Personengruppe zurück. |
|
Other Status Codes |
Unerwartete Fehlerantwort. Header x-ms-error-code: string |
Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.
Typ:
apiKey
In:
header
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
Name | Beschreibung |
---|---|
https://cognitiveservices.azure.com/.default |
Beispielanforderung
GET {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_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
}
Name | Beschreibung |
---|---|
Face |
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. |
Face |
Eine Antwort, die Fehlerdetails enthält. |
Operation |
Der Status des Vorgangs mit langer Ausführung. |
Training |
Schulungsergebnis eines Containers |
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. |
Eine Antwort, die Fehlerdetails enthält.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
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. |
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 |
Schulungsstatus des Containers. |