检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 公共消息头 消息对象结构 自定义字段 sort语法 filter语法
Java SDK 入门指导 SDK接口示例 SDK & API对应关系
错误码类 调用API报错时怎么处理
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供Java语言的SDK供您使用，SDK的使用方法请参见SDK参考。 父主题： 使用前必读
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题： API
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token接口来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} /
入门指导 环境准备 开通人脸识别服务：登录人脸识别管理控制台，选择对应的子服务，单击右侧的“开通服务”。 服务开通一次即可，后续使用时无需再开通。 获取人脸识别服务的终端节点（Endpoint），请参见地区和终端节点。 获取并了解人脸识别API，请参见《人脸识别API参考》。 获取华为云账号的
区域与可用区 什么是区域和可用区域
数据安全类 使用FRS服务，是否会保存用户数据
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 Token的有效期为24小时，需要使用同一个
sort语法 json array形式，排序只支持数值类型，字段重复定义会被覆盖。 例1：单个排序字段 "sort":[ { "location": "desc" } ] 例2：多个排序字段 "sort": [
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题： API
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征
FRS自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容
filter语法 数值类型 数值类型的范围查询，[]包含两端点值，{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 单值。 rowkey:1
查询人脸 功能介绍 查询指定人脸库中人脸信息。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 URI GET /v2/{project_id}/face-sets/{face_set_name}/faces?offset=xxx&limit=xxx 或者 GET
删除人脸 功能介绍 根据指定字段删除人脸库中人脸。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 URI DELETE /v2/{project_id}/face-sets/{face_set_name}/faces?field_name=field_value
公共消息头 公共请求消息头 表1 公共请求消息头 参数名 说明 是否必选 示例 Content-type 消息体的类型（格式），默认取值为“application/json”。 是 application/json X-Project-Id project id，用于不同project
