Udostępnij za pośrednictwem


Face List Operations - Get Large Face List Training Status

Aby sprawdzić stan trenowania listy dużych twarzy został ukończony lub nadal trwa. Trenowanie dużej listy twarzy jest operacją asynchroniczną wyzwalaną przez funkcję "Train Large Face List".

Czas trenowania zależy od liczby wpisów twarzy na dużej liście twarzy. Może to być w sekundach lub do pół godziny dla 1000 000 twarzy.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
apiVersion
path True

string

Wersja interfejsu API

endpoint
path True

string

uri

Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://{nazwa-zasobu}.cognitiveservices.azure.com).

largeFaceListId
path True

string

Prawidłowy znak to litera w małych literach lub cyfrach lub "-" lub "_", maksymalna długość to 64.

Wzorzec wyrażenia regularnego: ^[a-z0-9-_]+$

Odpowiedzi

Nazwa Typ Opis
200 OK

TrainingResult

Pomyślne wywołanie zwraca stan trenowania dużej listy twarzy.

Other Status Codes

FaceErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Klucz tajny subskrypcji rozpoznawania twarzy usługi Azure AI.

Typ: apiKey
W: header

AADToken

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://api.example.com/oauth2/authorize
Adres URL tokenu: https://api.example.com/oauth2/token

Zakresy

Nazwa Opis
https://cognitiveservices.azure.com/.default

Przykłady

Get Training Status of LargeFaceList

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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
}

Definicje

Nazwa Opis
FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.

OperationStatus

Stan długotrwałej operacji.

TrainingResult

Wynik trenowania kontenera

FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

Nazwa Typ Opis
code

string

Jeden z zdefiniowanych przez serwer zestaw kodów błędów.

message

string

Czytelna dla człowieka reprezentacja błędu.

FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.

Nazwa Typ Opis
error

FaceError

Obiekt błędu.

OperationStatus

Stan długotrwałej operacji.

Nazwa Typ Opis
failed

string

Operacja nie powiodła się.

notStarted

string

Operacja nie została uruchomiona.

running

string

Operacja jest nadal uruchomiona.

succeeded

string

Operacja zakończyła się pomyślnie.

TrainingResult

Wynik trenowania kontenera

Nazwa Typ Opis
createdDateTime

string

Połączony ciąg daty i godziny UTC opisujący utworzony czas grupy osób, grupy dużych osób lub dużej listy twarzy.

lastActionDateTime

string

Połączony ciąg daty i godziny UTC, który opisuje czas ostatniej modyfikacji grupy osób, grupy dużej osoby lub dużej listy twarzy, może mieć wartość null, gdy grupa nie została pomyślnie wytrenowana.

lastSuccessfulTrainingDateTime

string

Połączony ciąg daty i godziny UTC opisujący ostatni udany czas szkolenia grupy osób, grupy dużej osoby lub dużej listy twarzy.

message

string

Pokaż komunikat o niepowodzeniu w przypadku niepowodzenia trenowania (pominięty po pomyślnym zakończeniu trenowania).

status

OperationStatus

Stan trenowania kontenera.