Person Group Operations - Get Large Person Group Training Status

Szolgáltatás:

Azure AI Services

API-verzió:

v1.1-preview.1

A Large Person Group betanítási állapotának ellenőrzése befejeződött vagy még folyamatban van. A Large Person Group betanítása egy aszinkron művelet, amelyet a "Train Large Person Group" API aktivál.
A betanítási idő a személyek bejegyzéseinek számától és az arcuktól függ egy nagy személycsoportban. Lehet másodpercben, vagy akár fél óra 1 000 000 személy számára.

GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/training

URI-paraméterek

Name	In	Kötelező	Típus	Description
apiVersion	path	True	string	API-verzió
endpoint	path	True	string uri	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com).
largePersonGroupId	path	True	string	A tároló azonosítója. Reguláris kifejezési minta: ^[a-z0-9-_]+$

Válaszok

Name	Típus	Description
200 OK	TrainingResult	A sikeres hívás visszaadja a Nagy személycsoport betanítási állapotát.
Other Status Codes	FaceErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Az Azure AI Face-előfizetés titkos kulcsa.

Típus: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2 flow

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://api.example.com/oauth2/authorize
Jogkivonat URL-címe: https://api.example.com/oauth2/token

Hatókörök

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

Példák

Get Training Status of LargePersonGroup

Mintakérelem

HTTP

GET {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id/training

Mintaválasz

Állapotkód:

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
}

Definíciók

Name	Description
FaceError	A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hibaadatokat tartalmazó válasz.
OperationStatus	A hosszú ideig futó művelet állapota.
TrainingResult	Tároló betanítási eredménye

FaceError

A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
message	string	A hiba emberi olvasásra alkalmas ábrázolása.

FaceErrorResponse

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.

OperationStatus

A hosszú ideig futó művelet állapota.

Name	Típus	Description
failed	string	A művelet sikertelen.
notStarted	string	A művelet nem indult el.
running	string	A művelet továbbra is fut.
succeeded	string	A művelet sikeres.

TrainingResult

Tároló betanítási eredménye

Name	Típus	Description
createdDateTime	string	Kombinált UTC dátum- és idősztring, amely leírja a személycsoport, a nagy személycsoport vagy a nagy arclista létrehozási idejét.
lastActionDateTime	string	Egy kombinált UTC dátum- és idősztring, amely a személycsoport, a nagy személycsoport vagy a nagy arclista utolsó módosítási időpontját írja le, null értékű lehet, ha a csoport betanítása nem sikerült.
lastSuccessfulTrainingDateTime	string	Kombinált UTC dátum- és idősztring, amely a személycsoport, a nagy személycsoport vagy a nagy arclista utolsó sikeres betanítási idejét írja le.
message	string	Sikertelen betanítás esetén megjelenő hibaüzenet (a sikeres betanításkor nem jelenik meg).
status	OperationStatus	A tároló betanítási állapota.