你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Large Person Group Person - Update Face

Service:

Cognitive Services - Face

API Version:

1.0

更新某个人员的持久性人脸的 userData 字段。

PATCH {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}

URI 参数

名称	在	必需	类型	说明
Endpoint	path	True	string	支持的认知服务终结点 (协议和主机名，例如： https://westus.api.cognitive.microsoft.com) 。
largePersonGroupId	path	True	string	引用特定大型人员组的 ID。 Regex pattern: ^[a-z0-9-_]+$
persistedFaceId	path	True	string uuid	引用现有人脸的特定 persistedFaceId 的 ID。
personId	path	True	string uuid	引用特定人员的 ID。

请求头

名称	必需	类型	说明
Ocp-Apim-Subscription-Key	True	string

请求正文

名称	类型	说明
userData	string	用户提供的数据附加到人脸。 大小限制为 1KB。

响应

名称	类型	说明
200 OK		成功的调用将返回空的响应正文。
Other Status Codes	APIError	错误响应。

安全性

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

示例

Update person face example

Sample Request

HTTP

PATCH {Endpoint}/face/v1.0/largepersongroups/abc/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces/62004fa7-1ac0-478e-9d5a-b38f9e7fbc68


{
  "userData": "User-provided data attached to the face."
}

Sample Response

Status code:

200

定义

名称	说明
APIError	API 返回的错误信息
Error	错误正文。
UpdateFaceRequest	请求更新人脸数据。

APIError

API 返回的错误信息

名称	类型	说明
error	Error	错误正文。

Error

错误正文。

名称	类型	说明
code	string
message	string

UpdateFaceRequest

请求更新人脸数据。

名称	类型	说明
userData	string	用户提供的数据附加到人脸。 大小限制为 1KB。