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."
}
}
~~~
- 空白目录
- 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