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

删除人脸

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

功能介绍

指定一个字段,根据该字段删除人脸库中的一个人脸。

URI

  • URI格式
    DELETE /v1/{project_id}/face-sets/{face_set_name}/faces?field_name=field_value
  • 参数说明

    参数名

    参数类型

    是否必选

    说明

    project_id

    String

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

    face_set_name

    String

    人脸库名称。

    field_name

    String

    按条件删除的字段名,支持固定字段(external_image_id和face_id),以及用户的自定义字段(不支持空字符串和null值删除)。

请求消息

NA

响应消息

表1 响应参数

参数名

参数类型

说明

face_set_name

String

人脸库名称。

调用失败时无此字段。

face_set_id

String

人脸库ID。

调用失败时无此字段。

face_number

Integer

删除的人脸数量。

调用失败时无此字段。

error_code

String

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

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求样例(方式一:使用external_image_id删除)
    DELETE https://{endpoint}/v1/{project_id}/face-sets/showFaceSet/faces?external_image_id=imageID
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
  • 请求样例(方式二:使用face_id删除)
    DELETE https://{endpoint}/v1/{project_id}/face-sets/showFaceSet/faces?face_id=faceID
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
  • 请求样例(方式三:自定义字段删除)
    DELETE https://{endpoint}/v1/{project_id}/face-sets/showFaceSet/faces?id=home
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
  • 响应样例
    {
      "face_number": 1,
      "face_set_id": "T785tx1N",
      "face_set_name": "showFaceSet"
    }
  • 失败响应样例
    {
      "error_code": "FRS.0402",
      "error_msg": "External id is not exist, can not delete face"
    }
分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区