# 批量修改目标信息 #### 功能介绍 批量修改目标信息，仅支持好望协议设备，使用该接口需要设备安装了目标算法，NVR800需要切换到人卡模式，SDC直连需要开启目标库对比 #### URI PUT /v1/{user_id}/targets 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user_id | 是 | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215) | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Access-Token | 是 | String | 用户认证AccessToken：从[获取用户北向接口认证AccessToken](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html)中获取 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | device_id | 是 | String | 设备ID： 好望设备：大小写字母、数字组成，长度范围\[8,32\]，可在设备外壳或者设备web页面上获取 | | group_id | 是 | Integer | 目标库分组ID：非负值，[从获取目标库分组接口获取](https://support.huaweicloud.com/api-ivm/ivm_03_0103.html) | | targets | 是 | [TargetDto] object | 目标数据列表： NVR800和IVS1800：9.1以上版本支持该接口，支持批量修改，最多支持修改20个目标，NVR800的所有图片合计最大为700K，NVR800在脱敏库中目标无法进行修改 SDC：仅支持单目标修改 | | storage | 否 | Boolean | 是否保存图片：false-不保存图片，true-保存图片，默认值true，NVR800的不保存图片就会保存到脱敏名单库中，SDC和NVR800修改时该字段不生效 | 表4TargetDto | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | target_id | 是 | String | 目标ID：支持数字和-，长度范围\[1,20\]，需要已添加目标才可以修改，可以从[按索引范围获取目标ID列表](https://support.huaweicloud.com/api-ivm/ivm_03_0111.html)、[获取目标信息](https://support.huaweicloud.com/api-ivm/ivm_03_0110.html)、[按索引范围获取目标ID信息](https://support.huaweicloud.com/api-ivm/ivm_03_0122.html)中获取 | | name | 是 | String | 姓名：支持中英文、数字、特殊字符（_-空格），长度范围\[1,128\] | | gender | 是 | String | 性别：枚举类型 枚举值： - **male** 男性 - **female** 女性 | | age | 否 | Integer | 年龄：取值范围\[1,255\]（仅NVR800支持） | | country | 否 | String | 国家：支持大小写字母数字，长度范围\[1,128\]（SDC不支持） | | nation | 否 | String | 民族：支持大小写字母数字，长度范围\[1,32\]（暂不支持） | | native | 否 | String | 籍贯：支持大小写字母数字，长度范围\[1,128\]（IVS1800不支持） | | occupation | 否 | String | 职业：支持大小写字母数字，长度范围\[1,128\]（SDC不支持） | | work_no | 否 | String | 工号或身份证号之类：支持大小写数字，长度范围\[1,64\] | | phone | 否 | String | 电话：11位纯数字（仅NVR800支持） | | email | 否 | String | 邮箱：邮箱格式，\*\*\****@***.\*\*\*（仅NVR800支持） | | remark | 否 | String | 备注信息：支持大小写字母数字，长度范围\[1,512\]（SDC不支持） | | jpegBase64 | 是 | String | 目标图片：经过base64编码（单个图片建议不超过50K），支持png、jpeg、jpg格式 | | domicile | 否 | String | 居住地：支持大小写字母数字，长度范围\[1,256\]（IVS1800不支持） | #### 响应参数 **状态码： 200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | group_id | Integer | 目标库分组ID：目标库标识符 | | target_ids | Array of [TargetResultVo] objects | 目标ID列表 | 表6TargetResultVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | target_id | String | 目标ID：目标标识符 | | result | [Result] object | 结果信息 | | external_target_id | String | 用户传入的目标ID：用户自定义的，在[添加目标](https://support.huaweicloud.com/api-ivm/ivm_03_0113.html)的时候由客户填入 | 表7Result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 错误编码 | | msg | String | 错误信息 | #### 请求示例 批量修改目标信息 ``` PUT /v1/2562572829***/targets { "device_id":"952352LWXT***", "group_id":2, "targets":[ { "target_id":"2", "name":"mark", "gender":"male", "age":24, "country":"中国", "nation":"汉", "native":"杭州", "occupation":"工人", "work_no":"124****77", "phone":"15********61", "email":"1*********@qq.com", "domicile":"杭州", "remark":"无", "jpegBase64":"/9j/4AAQSkZJRgABAQAAAQABAAD..."}] } ``` #### 响应示例 **状态码： 200** OK ``` { "group_id" : 2, "target_ids" : [ { "result" : { "code" : "IVM.0", "msg" : "Success" }, "target_id" : "2", "external_target_id" : "1234567890123456" } ] } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html) #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)