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."
}
}
~~~
- 空白目录
- Face
- Detect
- Find Similar
- Group
- Identify
- Verify
- Face List
- Add a Face to a Face List
- Create a Face List
- Delete a Face from a Face List
- Delete a Face List
- Get a Face List
- List Face Lists
- Update a Face List
- Person
- Add a Person Face
- Create a Person
- Delete a Person
- Delete a Person Face
- Get a Person
- Get a Person Face
- List Persons in a Person Group
- Update a Person
- Update a Person Face
- Person Group
- Create a Person Group
- Delete a Person Group
- Get a Person Group
- Get Person Group Training Status
- List Person Groups
- Train Person Group
- Update a Person Group