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

Person Directory Operations - Update Person Face

更新人员的持久化人脸的 userData 字段。

PATCH {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces/{persistedFaceId}

URI 参数

名称 必需 类型 说明
apiVersion
path True

string

API 版本

endpoint
path True

string

uri

支持的认知服务终结点 (协议和主机名,例如:https://{resource-name}.cognitiveservices.azure.com) 。

persistedFaceId
path True

string

uuid

人脸的人脸 ID。

personId
path True

string

uuid

人员 ID。

recognitionModel
path True

RecognitionModel

与人脸关联的“recognitionModel”。

请求正文

名称 类型 说明
userData

string

用户提供的数据附加到人脸。 长度限制为 1K。

响应

名称 类型 说明
200 OK

请求已成功。

Other Status Codes

FaceErrorResponse

意外的错误响应。

标头

x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

Azure AI 人脸订阅的密钥。

类型: apiKey
在: header

AADToken

Azure Active Directory OAuth2 流

类型: oauth2
流向: accessCode
授权 URL: https://api.example.com/oauth2/authorize
令牌 URL: https://api.example.com/oauth2/token

作用域

名称 说明
https://cognitiveservices.azure.com/.default

示例

Update Face of PersonDirectory Person

示例请求

PATCH {endpoint}/face/v1.1-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

{
  "userData": "your_user_data"
}

示例响应

定义

名称 说明
FaceError

错误对象。 有关人脸服务返回的错误代码和消息的完整详细信息,请参阅以下链接: https://aka.ms/face-error-codes-and-messages

FaceErrorResponse

包含错误详细信息的响应。

RecognitionModel

人脸的识别模型。

FaceError

错误对象。 有关人脸服务返回的错误代码和消息的完整详细信息,请参阅以下链接: https://aka.ms/face-error-codes-and-messages

名称 类型 说明
code

string

服务器定义的一组错误代码中的一个。

message

string

错误的用户可读表示形式。

FaceErrorResponse

包含错误详细信息的响应。

名称 类型 说明
error

FaceError

错误对象。

RecognitionModel

人脸的识别模型。

名称 类型 说明
recognition_01

string

“Detect”的默认识别模型。 在 2019 年 3 月之前创建的所有 faceId 都与此识别模型绑定。

recognition_02

string

2019 年 3 月发布的识别模型。

recognition_03

string

识别模型于 2020 年 5 月发布。

recognition_04

string

识别模型于 2021 年 2 月发布。 建议使用此识别模型来提高识别准确性。