Person Group - Train Person Group 排隊人員訓練任務，訓練任務可能無法立即開始。 直到person group成功訓練，person group才會更新生效。可以通過調用Person Group - Get Person Group Training Status API 來查詢培訓狀態 Http Method `POST` Request URL `https://api.cognitive.azure.cn/face/v1.0/persongroups/{personGroupId}/train ` Request parameters | 參數名|參數類型 |描述 | | --- | --- | --- | | personGroupId |string | 定位person group進行培訓| 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。 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 and message returned in JSON: | Error Code | Error Message Description | | --- | --- | | PersonGroupNotFound | PersonGroupID無效。有效格式應該是由數字組成的字符串，英文字母小寫，' - '，'_'，不超過64個字符 | | PersonGroupNotFound | 找不到PersonGroup| ~~~ { "error":{ "code":"PersonGroupNotFound", "message":"Person group 'sample_group' is not found." } } ~~~ Response 409 | Error Code | Error Message Description | | --- | --- | | PersonGroupTrainingNotFinished | Person group正在接受培訓 | | ConcurrentOperationConflict | 資源并發操作沖突| ~~~ { "error":{ "code":"PersonGroupTrainingNotFinished", "message":"Person group 'sample_group' is under training." } } ~~~ Response 429 ~~~ { "error":{ "statusCode": 429, "message": "Rate limit is exceeded. Try again in 26 seconds." } } ~~~