文档首页> 人脸识别服务 FRS> API参考> API> 人脸资源管理> 更新人脸
更新时间：2022-04-15 GMT+08:00
查看PDF
分享

更新人脸

功能介绍

根据人脸ID（face_id）更新单张人脸信息。

前提条件：

请确保您已开通人脸搜索服务。

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

调试

您可以在API Explorer中调试该接口。

URI

PUT /v2/{project_id}/face-sets/{face_set_name}/faces

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

face_set_name

是

String

人脸库名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

用于获取操作API的权限。获取方法请参见认证鉴权。
表3 请求Body参数

参数名

参数类型

是否必选

说明

face_id

String

是

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

external_image_id

String

否

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

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

external_fields

Object

否

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

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

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

face_number

Integer

更新的人脸数量。 调用失败时无此字段。

face_set_id

String

人脸库ID。 调用失败时无此字段。

face_set_name

String

人脸库名称。 调用失败时无此字段。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。

error_msg

String

调用失败时的错误信息。 调用成功时无此字段。

请求示例

X-Auth-Token值获取方法请参见快速入门。

  • 请求样例
    PUT https://{endpoint}/v2/{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"
  }
}
  • Python3语言请求代码示例（其他语言参照下列示例编写或使用FRS SDK）
    # -*- coding:utf-8 -*-

import requests
import base64

endpoint = '开通服务所在region的人脸识别服务域名'
project_id = '开通服务所在region的用户项目ID'
token = '用户获取得到的实际token值'
headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}

face_set_name = 'showFaceSet'
url = "https://{endpoint}/v2/{project_id}/face-sets/{face_set_name}/faces".format(
    endpoint=endpoint, project_id=project_id, face_set_name=face_set_name)
body = {
    "face_id": "iexEBb6t",
    "external_image_id": "imageID",
    "external_fields": {
        "timestamp": 12,
        "id": "300018629384756"
    }
}
response = requests.put(url, headers=headers, json=body, verify=False)
print(response.text)
  • Java语言请求代码示例（其他语言参照下列示例编写或使用FRS SDK）
    import com.huawei.trace.http.apache.httpclient.TraceApacheHttpClientBuilder;
import org.apache.http.HttpEntity;
import org.apache.http.HttpHeaders;
import org.apache.http.HttpResponse;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.methods.HttpPut;
import org.apache.http.config.Registry;
import org.apache.http.config.RegistryBuilder;
import org.apache.http.conn.socket.ConnectionSocketFactory;
import org.apache.http.conn.socket.PlainConnectionSocketFactory;
import org.apache.http.conn.ssl.NoopHostnameVerifier;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
import org.apache.http.ssl.SSLContextBuilder;
import org.apache.http.ssl.TrustStrategy;
import org.apache.http.util.EntityUtils;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.security.KeyManagementException;
import java.security.KeyStoreException;
import java.security.NoSuchAlgorithmException;
import java.security.cert.CertificateException;
import java.security.cert.X509Certificate;
import java.util.concurrent.TimeUnit;
import javax.net.ssl.HostnameVerifier;
import javax.net.ssl.SSLContext;

/**
 * 此demo仅供测试使用，强烈建议使用SDK
 * 使用前需已配置HttpClient jar包。jar包可通过下载SDK获取
 */

public class UpdateFaceByFaceId {
    protected static HttpClientBuilder buildClient(HttpClientBuilder httpClientBuilder) {
        SSLContext sslContext = null;
        try {
            sslContext = new SSLContextBuilder().loadTrustMaterial(null, new TrustStrategy() {
                public boolean isTrusted(X509Certificate[] arg0, String arg1) throws CertificateException {
                    return true;
                }
            }).build();
        } catch (NoSuchAlgorithmException e) {
            throw new RuntimeException(e.getMessage());
        } catch (KeyManagementException e) {
            throw new RuntimeException(e.getMessage());
        } catch (KeyStoreException e) {
            throw new RuntimeException(e.getMessage());
        }
        httpClientBuilder.setSSLContext(sslContext);
        httpClientBuilder.setConnectionTimeToLive(30, TimeUnit.SECONDS);
        HostnameVerifier hostnameVerifier = NoopHostnameVerifier.INSTANCE;
        SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(sslContext, hostnameVerifier);
        Registry<ConnectionSocketFactory> socketFactoryRegistry
            = RegistryBuilder.<ConnectionSocketFactory>create().register("http",
            PlainConnectionSocketFactory.getSocketFactory()).register("https", sslSocketFactory).build();
        PoolingHttpClientConnectionManager connMgr = new PoolingHttpClientConnectionManager(socketFactoryRegistry);
        connMgr.setMaxTotal(200);
        connMgr.setDefaultMaxPerRoute(100);
        httpClientBuilder.setConnectionManager(connMgr);
        return httpClientBuilder;
    }

    public static String doPut(String url, String jsonStr, String token, CloseableHttpClient client) {
        HttpPut put = new HttpPut(url);
        put.setHeader(HttpHeaders.CONTENT_TYPE, "application/json");
        StringEntity entity = new StringEntity(jsonStr, ContentType.APPLICATION_JSON);
        put.setEntity(entity);
        put.setHeader(HttpHeaders.CONTENT_TYPE, "application/json");
        //time unit is milliseconds
        RequestConfig requestConfig = RequestConfig.custom().setConnectTimeout(3000).setSocketTimeout(3000).build();
        put.setConfig(requestConfig);
        put.setHeader("X-Auth-Token", token);
        HttpResponse response = null;
        String result = "";
        try {
            response = client.execute(put);
            HttpEntity responseBody = response.getEntity();
            if (responseBody == null) {
                System.out.println("the response body is null.");
                return result;
            } else {
                byte[] byteStream = EntityUtils.toByteArray(responseBody);
                System.arraycopy(byteStream, 0, new byte[byteStream.length], 0, byteStream.length);
                result = new String(byteStream, StandardCharsets.UTF_8);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return result;
    }

    public static void main(String[] args) {
        CloseableHttpClient client = buildClient(TraceApacheHttpClientBuilder.create()).build();
        // endpoint,project_id和face_set_name需要替换成实际信息。
        String url = "https://{{endpoint}}/v2/{{project_id}}/face-sets/{{face_set_name}}/faces";
        String token = "对应region的token";
        String jsonStr = "{ \"face_id\": \"iexEBb6t\", \"external_image_id\": \"imageID\", \"external_fields\": { \"timestamp\": 12, \"id\": \"300018629384756\" }}";
        String result = doPut(url, jsonStr,token, client);
        System.out.println(result);
    }
}

响应示例

状态码：200

成功响应样例
{
  "face_number": 1,
  "face_set_id": "T785tx1N",
  "face_set_name": "showFaceSet"
}

状态码：400

失败响应样例
{
  "error_code": "FRS.0303",
  "error_msg": "The face id is not exist, checkout your input."
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 人脸资源管理
分享：

    相关文档

    相关产品

关闭导读