# 重置设备指纹
#### 功能介绍
应用服务器可调用此接口重置设备指纹。携带指定设备指纹时将之重置为指定值；不携带时将之置空，后续设备第一次接入时，该设备指纹的值将设置为第一次接入时的证书指纹。
#### URI
POST /v5/iotps/{project_id}/devices/{device_id}/reset-fingerprint
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。 最小长度：**1** 最大长度：**32**                                                                                                                      |
| device_id  | 是    | String | **参数说明** ：设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "*" + "node_id"拼接而成。 **取值范围**：长度不超过128，只允许字母、数字、下划线（*）、连接符（-）的组合。 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                    |
|:---|:---|:---|:---|
| fingerprint | 否    | String | **参数说明** ：设备指纹。设置改字段时平台将设备指纹重置为指定值；不携带时将之置空，后续设备第一次接入时，该设备指纹的值将设置为第一次接入时的证书指纹。 **取值范围**：长度为40的十六进制字符串或者长度为64的十六进制字符串。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数          | 参数类型   | 描述                                                                                                      |
|:---|:---|:---|
| device_id   | String | 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "_" + "node_id"拼接而成。 最大长度：**256** |
| fingerprint | String | 设备指纹。                                                                                                   |
   
#### 请求示例
```
POST https://{endpoint}/v5/iotps/{project_id}/devices/{device_id}/reset-fingerprint
```
#### 响应示例
**状态码： 200**
OK
```
{
  "device_id" : "d4922d8a-6c8e-4396-852c-164aefa6638f",
  "fingerprint" : "dc0f1016f495157344ac5f1296335cff725ef22f"
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 403 | Forbidden             |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iotps/ErrorCode.html)。