Person Group Operations - Get Person Group Training Status
So überprüfen Sie den Status der Person-Gruppe abgeschlossen oder noch fortlaufend. Die Person-Gruppenschulung ist ein asynchroner Vorgang, der durch die API "Train Person Group" ausgelöst wird.
GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/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). |
person
|
path | True |
string |
ID des Containers. RegEx-Muster: |
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Ein erfolgreicher Anruf gibt den Schulungsstatus der 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/persongroups/your_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. |