第三方平台定时将设备资产信息上报到本级平台。
    设备资产内容包含但不限于第三方平台的资产名称、单位名称、资产类型、资产标签、责任人、资产重要性、ipv4、ipv6、mac地址、是否国产、是否物联网终端、互联网数据中心、资产编号、资产状态、使用人、机密性、完整性、可用性、区域、操作系统信息、设备信息等。

    请求地址:/open/api/v1/ asset/add
    接口类型: HTTP
    请求方式:POST
    请求参数:

    序号 字段名称 中文名称 字段说明 字段长度 必填/可选 说明
    1 user 第三方系统用户名 文本 10 必填
    2 timestamp 请求发起时间戳 整数 64 必填
    3 sign md5(timestamp+user+token) 字符 32 必填
    4 dataValues 对象数组 对象
    必填

    dataValues包含的字段:

    序号 字段名称 中文名称 字段说明 字段长度 必填/可选 说明
    1 name 资产名称 字符 50 必填 资产名称
    2 companyName 单位名称 字符 50 必填 单位存在,才能正常新增
    3 type 资产类型 字符 10 可选 资产类型:详见附录B.1 补充说明枚举值
    4 tags 资产标签 字符 50 可选 资产标签,逗号相连(自定义,如:网络,终端,云)
    5 personInCharge 责任人 字符 10 可选 责任人
    6 importance 资产重要性 字符 10 可选 资产重要性:common|important
    7 ipv4 ipv4 字符 100 可选 ipv4存放json数组
    8 ipv6 ipv6 字符 100 可选 ipv6存放json数组
    9 mac Mac地址 字符 100 可选 Mac地址
    10 domesticProduct 是否国产 字符 10 可选 是否国产:1|0
    11 iotDevice 是否物联网终端 字符 10 可选 是否物联网终端:1|0
    12 idc 互联网数据中心 字符 10 可选 互联网数据中心
    13 code 资产编号 字符 10 可选 资产编号
    14 status 资产状态 字符 10 可选 资产状态,枚举:installed|testing|using|maintaining|spare|scrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废
    15 assetUser 使用人 字符 10 可选 使用人
    16 confidentiality 机密性 字符 10 可选 机密性,枚举:veryHigh|high|medium|low|ignorable含义分别是:非常高|高|中|低|可忽略
    17 integrity 完整性 字符 10 可选 完整性,枚举:veryHigh|high|medium|low|ignorable含义分别是:非常高|高|中|低|可忽略
    18 availability 可用性 字符 10 可选 可用性,installed|testing|using|maintaining|spare|scrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废
    19 hierarchyProtection 是否是等保 字符 10 可选 是否是等保,枚举1|0
    20 province 省名称 字符 10 可选 省名称
    21 city 市名称 字符 10 可选 市名称
    22 county 区名称 字符 10 可选 区名称
    23 description 描述 字符 1000 可选 描述
    24 os 操作系统 字符 10 可选 操作系统
    25 osVersion 操作系统版本号 字符 10 可选 操作系统版本号
    26 deviceManufacturer 设备厂商 字符 10 可选 设备厂商
    27 deviceModel 设备型号 字符 30 可选 设备型号
    28 deviceVersion 设备版本 字符 30 可选 设备版本
    29 storeLocation 设备存放地址 字符 100 可选 设备存放地址

    请求示例:

    1. 返回示例:
    2. {
    3. "dataValues": [
    4. {
    5. "name": "资产openapi-006", //资产名称【string, 必填】
    6. "companyName": "测试", //单位名称,单位存在,才能正常新增【string, 必填】
    7. "type": "54,59", // 资产类型:详见补充说明枚举值 string, 选填】
    8. "tags": "111,222", // 资产标签,逗号相连 string, 选填】
    9. "personInCharge": "xiaoming", // 责任人 string, 选填】
    10. "importance": "important", // 资产重要性:commonimportant string, 选填】
    11. "ipv4": "[\"1.4.2.4\"]", // ipv4存放json数组【string, 选填】
    12. "ipv6": "[\"2001:0db8:85a3:0000:0000:8a2e:0370:7331\"]", // ipv6存放json数组【string, 选填】
    13. "mac": "[\"99:DD:6B:B3:45:0C\"]", // mac string, ipv4ipv6mac三个必须至少填1个】
    14. "domesticProduct": "0",// 是否国产:10string, 选填】
    15. "iotDevice": "0", // 是否物联网终端:10string, 选填】
    16. "idc": "idc111", // idc:互联网数据中心【string, 选填】
    17. "code": "code1111", //资产编号 string, 选填】
    18. "status": "testing", // 资产状态,枚举:installedtestingusingmaintainingsparescrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废 string, 选填】
    19. "assetUser": "xiaomei", // 使用人【string, 选填】
    20. "confidentiality": "high", // 机密性,枚举:veryHighhighmediumlowignorable含义分别是:非常高|高|中|低|可忽略【string, 选填】
    21. "integrity": "medium", // 完整性,枚举:veryHighhighmediumlowignorable含义分别是:非常高|高|中|低|可忽略【string, 选填】
    22. "availability": "maintaining", // 可用性,installedtestingusingmaintainingsparescrapped,分别表示:已安装|测试中|使用中|维护中|备用|报废 string, 选填】
    23. "hierarchyProtection": 1, // 是否是等保,枚举 10 string, 选填】
    24. "province": "浙江省", // 省名称【string, 选填】
    25. "city": "杭州市", // 市名称【string, 选填】
    26. "county": "滨江区", // 区名称【string, 选填】
    27. "description": "description1111", // 描述 string, 选填】
    28. "os": "os1111", // 操作系统 string, 选填】
    29. "osVersion": "osvesion111", // 操作系统版本号 string, 选填】
    30. "deviceManufacturer": "设备厂商111", // 设备厂商 string, 选填】
    31. "deviceModel": "设备型号111", // 设备型号 string, 选填】
    32. "deviceVersion": "设备版本111", // 设备版本 string, 选填】
    33. "storeLocation": "设备存放地址111"// 设备存放地址 string, 选填】
    34. }
    35. ],
    36. "sign": "xxxxxxxxxxx",
    37. "timestamp": 1620464511673,
    38. "user": "xxxx"
    39. }

    返回参数:

    序号 字段名称 中文名称 字段说明 说明
    1 errorCode 接口状态码 字符
    2 errorMessage 接口消息 字符
    3 data 接口数据 对象
    4 success 是否成功 布尔 true:成功,false:错误

    返回示例:

    1. {
    2. "data": {},
    3. "errorCode": "",
    4. "errorMessage": "",
    5. "success": true
    6. }