Face List Operations - Get Large Face List Training Status

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2-preview.1

A Large Face List betanítási állapotának ellenőrzése befejeződött vagy még folyamatban van. A Large Face List betanítása a "Nagy arclista betanítása" által aktivált aszinkron művelet.

A betanítási idő a nagyméretű arcok listájában szereplő arcbejegyzések számától függ. Ez lehet másodpercek alatt, vagy akár fél óra 1 000 000 arc esetén.

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/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).
largeFaceListId	path	True	string	Az érvényes karakter kisbetűs vagy számjegyű, "-" vagy "_", maximális hossza 64. Reguláris kifejezési minta: ^[a-z0-9-_]+$

Válaszok

Name	Típus	Description
200 OK	TrainingResult	Egy sikeres hívás visszaadja a Large Face List 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 LargeFaceList

Mintakérelem

HTTP

GET {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_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 ember által olvasható á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 indul 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	A személycsoport, a nagy személycsoport vagy a nagy arclista utolsó módosítási idejét leíró kombinált UTC dátum- és idősztring 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 hibaüzenet jelenik meg (a betanítás sikeres végrehajtásakor nem jelenik meg).
status	OperationStatus	A tároló betanítási állapota.