文档首页 > > API参考> 人脸识别API(V1)> 人脸资源管理> 更新人脸

更新人脸

分享
更新时间: 2019/11/08 GMT+08:00

功能介绍

根据人脸ID(face_id)更新单张人脸信息。

application/json请求的body中,请使用标准Json格式。

URI

  • URI格式
    PUT   /v1/{project_id}/face-sets/{face_set_name}/faces
  • 参数说明

    参数名

    参数类型

    是否必选

    说明

    project_id

    String

    项目ID,获取方法请参见获取项目ID/账号名/AK/SK

    face_set_name

    String

    人脸库名称。

请求消息

表1 请求参数

参数名

参数类型

是否必选

说明

face_id

String

人脸ID,由系统内部生成的唯一ID。

external_image_id

String

用户指定的图片外部ID,与当前图像绑定。用户没提供,系统会生成一个。该ID长度范围为1~36位,可以包含字母、数字、中划线或者下划线,不包含其他的特殊字符。

这里是待修改的参数,external_image_id和external_fields至少选一个。

external_fields

Json

Json字符串不校验重复性,自定义字段的key值长度范围为[1,36],string类型的value长度范围为[1,256],具体参见自定义字段

这里是待修改的参数,external_image_id和external_fields至少选一个。

响应消息

表2 响应参数

参数名

参数类型

说明

face_set_name

String

人脸库名称。

调用失败时无此字段。

face_set_id

String

人脸库ID。

调用失败时无此字段。

face_number

Integer

更新的人脸数量。

调用失败时无此字段。

error_code

String

调用失败时的错误码,具体请参考错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求样例
    PUT https://{endpoint}/v1/{project_id}/face-sets/showFaceSet/faces
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
    
    Request Body:
    {
      "face_id": "iexEBb6t", 
      "external_image_id": "imageID",
      "external_fields": {
         "timestamp": 12,
         "id": "300018629384756"
      }
    }
  • 响应样例
    {
      "face_number": 1,
      "face_set_id": "T785tx1N",
      "face_set_name": "showFaceSet"
    }
  • 失败响应样例
    {
      "error_code": "FRS.0303",
      "error_msg": "The face id is not exist, checkout your input."
    }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问