Sdílet prostřednictvím


Face List Operations - Get Large Face List Training Status

Chcete-li zkontrolovat stav trénování velkého seznamu tváří dokončeno nebo stále probíhá. Trénování seznamu velkých tváří je asynchronní operace aktivovaná trénováním velkého seznamu tváří.

Doba trénování závisí na počtu položek tváří ve velkém seznamu tváří. U 1 000 000 tváří to může být v řádu sekund nebo až půl hodiny.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
apiVersion
path True

string

Verze rozhraní API

endpoint
path True

string

uri

Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com)

largeFaceListId
path True

string

Platným znakem je malé písmeno nebo číslice nebo -nebo _, maximální délka je 64.

Vzor regulárního výrazu: ^[a-z0-9-_]+$

Odpovědi

Name Typ Description
200 OK

TrainingResult

Úspěšné volání vrátí stav trénování velkého seznamu tváří.

Other Status Codes

FaceErrorResponse

Neočekávaná chybová odpověď.

Hlavičky

x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč pro vaše předplatné Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

Name Description
https://cognitiveservices.azure.com/.default

Příklady

Get Training Status of LargeFaceList

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

OperationStatus

Stav dlouhotrvající operace.

TrainingResult

Výsledek trénování kontejneru

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name Typ Description
code

string

Jeden ze serverem definovaných chybových kódů.

message

string

Lidsky čitelná reprezentace chyby.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name Typ Description
error

FaceError

Objekt chyby.

OperationStatus

Stav dlouhotrvající operace.

Name Typ Description
failed

string

Operace se nezdařila.

notStarted

string

Operace není spuštěna.

running

string

Operace je stále spuštěná.

succeeded

string

Operace byla úspěšná.

TrainingResult

Výsledek trénování kontejneru

Name Typ Description
createdDateTime

string

Kombinovaný řetězec data a času UTC, který popisuje čas vytvoření skupiny osob, velké skupiny osob nebo velkého seznamu tváří.

lastActionDateTime

string

Kombinovaný řetězec data a času UTC, který popisuje čas poslední změny skupiny osob, velké skupiny osob nebo velkého seznamu tváří, může mít hodnotu null, pokud skupina není úspěšně vytrénována.

lastSuccessfulTrainingDateTime

string

Kombinovaný řetězec data a času UTC, který popisuje poslední úspěšný čas trénování skupiny osob, velké skupiny osob nebo velkého seznamu tváří.

message

string

Zobrazit zprávu o selhání při neúspěšném trénování (vynecháno, pokud je trénování úspěšné).

status

OperationStatus

Stav trénování kontejneru.