Person - Get a Person Face 检索关于永久人脸的信息（由persistedFaceId，personId及其所属的personGroupId指定） Http Method `GET` Request URL `https://api.cognitive.azure.cn/face/v1.0/persongroups/{personGroupId}/persons/{personId}/persistedFaces/{persistedFaceId} ` Request parameters | 参数 |类型 |描述 | | --- | --- | --- | | personGroupId | string | 指定包含目标人物的人物组 | | personId | string | 目标人脸所属的指定的人物personId | | persistedFaceId | string | 该人物的持久的目标人脸的persistedFaceId | 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 一个成功的调用返回连续的目标人脸的信息（persistedFaceId和userData）。 JSON fields in response body | Fields | Type | Description | | --- | --- | --- | | persistedFaceId | String| 目标人脸的persistedFaceId，具有连续性且不会过期。与Face - Detect创建的faceId不同，faceId在检测呼叫后的24小时内将失效。 | | userData | String | 用户提供的附加到该人脸上的数据| ~~~ { "persistedFaceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9", "userData":"User-provided data attached to the person" } ~~~ 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." } } ~~~ Response403 ~~~ { "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 | | --- | --- | | PersistedFaceNotFound | 无效的Face ID | | PersistedFaceNotFound | 找不到人脸 | | PersonGroupNotFound |人物组ID无效。有效的格式应该是由数字组成的字符串，英文字母小写，' - '，'_'，且不超过64个字符| | PersonGroupNotFound | 找不到Person group | | PersonNotFound | 无效的Person ID | | PersonNotFound | 找不到Person | ~~~ { "error":{ "code":"PersonGroupNotFound", "message":"Person group 'sample_group' is not found." } } ~~~ Response409 ~~~ { "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." } } ~~~