Person Group - Get Person Group Training Status 檢索person group的培訓狀態（已完成或正在進行）。培訓可以通過Person Group - Train Person Group API 來觸發。培訓將在服務器端處理一段時間 Http Method `GET` Request URL `https://api.cognitive.azure.cn/face/v1.0/persongroups/{personGroupId}/training ` Request parameters | 參數名|參數類型 |描述 | | --- | --- | --- | | personGroupId |string | 目標person group的personGroupId| Request headers | 請求頭 |類型 |描述 | | --- | --- | --- | | Ocp-Apim-Subscription-Key | string | Subscription key which provides access to this API. Found in your Cognitive Services accounts. | Request body Response 200 成功的通話將返回人員組的培訓狀態。 JSON fields in response body: | Fields | Type | Description | | --- | --- | --- | | status | String |培訓狀態：未開始，正在運行，成功，失敗。如果訓練過程正在等待執行，則狀態不會開始。如果培訓正在進行，狀態正在運行。狀態成功意味著這個人員組已經準備好了Face - Identify。狀態失敗往往是由于沒有人或在人員組中沒有堅持的面孔而造成的 | | createdDateTime | String | 描述人員組創建時間的合并UTC日期和時間字符串，由字母T分隔。Eg 1/3/2017 4:11:35 AM。 | | lastActionDateTime | String | 人員組在UTC中最后修改時間，當人員組未成功培訓時可能為空值 | | message | String | 訓練失敗時顯示失敗信息（訓練成功時省略） | ~~~ { "status":"succeeded", "createdDateTime": "1/3/2017 4:11:35 AM", "lastActionDateTime": null, "message": null } ~~~ Response 401 | Error Code | Error Message Description | | --- | --- | | Unspecified | 無效的subscription Key 或user/plan 被凍結 | ~~~ { "error":{ "code": "Unspecified", "message": "Access denied due to invalid subscription key. Make sure you are subscribed to an API you are trying to call and provide the right key." } } ~~~ Response 403 ~~~ { "error":{ "statusCode": 403, "message": "Out of call volume quota. Quota will be replenished in 2.12 days." } } ~~~ Response 404 | Error Code | Error Message Description | | --- | --- | | PersonGroupNotFound | PersonGroupID無效。有效格式應該是由數字組成的字符串，英文字母小寫，' - '，'_'，不超過64個字符 | | PersonGroupNotFound | 找不到PersonGroup。 | | PersonGroupNotTrained |PersonGroup尚未接受培訓。這個錯誤出現在獲得一個從未受過訓練的群體的訓練狀態上 | ~~~ { "error":{ "code":"PersonGroupNotFound", "message":"Person group 'sample_group' is not found." } } ~~~ Response 409 有資源的sample_group '沖突操作，請稍后再試。 ~~~ { "error":{ "code": ConcurrentOperationConflict, "message": "There is a conflict operation on resource 'sample_group', please try later." } } ~~~ Response 429 ~~~ { "error":{ "statusCode": 429, "message": "Rate limit is exceeded. Try again in 26 seconds." } } ~~~