Person - Get a Person 檢索一個人物的信息，包括已記錄的永存人臉、name和userData。 Http Method `GET` Request URL 請求URL `https://api.cognitive.azure.cn/face/v1.0/persongroups/{personGroupId}/persons/{personId} ` Request parameters | 參數名|參數類型 |描述 | | --- | --- | --- | | personGroupId |string | 指定包含目標人物的人物組| | personId |string | 指定人物| 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 | | --- | --- | --- | | personId | String| 檢索到的人物的personId | | persistedFaceIds | Array | 已有記錄的人臉的persistedFaceIds。這些persistedFaceIds是從Person - Add Person Face中返回的，且不會過期| | name | String | 人物顯示名稱 | | userData | String | 用戶提供的附加到該人的數據 | ~~~ { "personId":"25985303-c537-4467-b41d-bdb45cd95ca1", "persistedFaceIds":[ "015839fb-fbd9-4f79-ace9-7675fc2f1dd9", "fce92aed-d578-4d2e-8114-068f8af4492e", "b64d5e15-8257-4af2-b20a-5a750f8940e7" ], "name":"Ryan", "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." } } ~~~ 響應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 | person groupID無效。有效的格式應該是由數字組成的字符串，英文字母小寫，' - '，'_'，且不超過64個字符 | | PersonGroupNotFound | 未找到person group | | PersonNotFound |無效的Person ID| | PersonNotFound | 未找到Person | ~~~ { "error":{ "code":"PersonGroupNotFound", "message":"Person group 'sample_group' is not found." } } ~~~ Response 409 ~~~ { "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." } } ~~~