修复提交 配置结果失败后，需重新创建事务，更新业务之后再修复提交，新业务配置下发成功后，配置结果恢复成功。 请求示例 HTTP的示例 POST /restconf/operations/huawei-aoc-restconf-service-config:generic-ne-service-sync-to HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy { "input": { "user-transaction-id":"549e33c8-4829-4eda-9c66-0b406ab5ee37" } }

查询指定特性状态 请求示例 HTTP的示例 POST /restconf/operations/huawei-nce-aoc-gnd-config-state:query-gnd-config-state-by-feature-instances HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "input": { "offset": 1, "limit": 10, "device-id": "8d394835-cb84-38f3-a4d5-36a7f2075081", "sort-field": "-last-oper-time", "feature-path": "/huawei-ac-nes-device:nes/ne/huawei-nce-e-bd:bd" } }

实例级重下发 请求示例 HTTP的示例 POST /restconf/operations/huawei-aoc-restconf-service-config:generic-ne-service-sync-to HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "input": { "ne-ids": { "ne-id": "8d394835-cb84-38f3-a4d5-36a7f2075081", "service-type": [{ "service-type-path": "/huawei-ac-nes-device:nes/ne/huawei-nce-e-bd:bd/10" }] } } }

批量查询设备配置状态 请求示例 HTTP的示例 POST /restconf/operations/huawei-nce-aoc-gnd-config-state:query-gnd-config-state-by-devices HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "input": { "offset": 1, "limit": 10, "device-name": "", "device-id": [ "c07e46c0-d1dd-4c4a-b513-0405e2303991" ], "sort-field": "-config-state" } }

查询指定设备所有特性状态 请求示例 HTTP的示例 POST /restconf/operations/huawei-nce-aoc-gnd-config-state:query-gnd-config-state-by-features HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "input": { "offset": 1, "limit": 10, "device-id": "8d394835-cb84-38f3-a4d5-36a7f2075081", "sort-field": "-config-state" } }

设备级重下发 请求示例 HTTP的示例 POST /restconf/operations/huawei-aoc-restconf-service-config:generic-ne-service-sync-to HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "input": { "ne-ids": [{ "ne-id": "8d394835-cb84-38f3-a4d5-36a7f2075081", "service-sync-to-with-failed-service": false }] } }

特性级重下发 请求示例 HTTP的示例 POST /restconf/operations/huawei-aoc-restconf-service-config:generic-ne-service-sync-to HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "input": { "ne-ids": { "ne-id": "8d394835-cb84-38f3-a4d5-36a7f2075081", "service-type": [{ "service-type-path": "/huawei-ac-nes-device:nes/ne/huawei-nce-e-bd:bd" }] } } }

示例：修改指定pool1的DHCP地址池 URI: /restconf/v2/data/huawei-ac-nes-device:nes/ne/{ neId }/huawei-nce-e-dhcpv4:global-ip-pool/ pool1 Table1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 36个字节。满足正则表达[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}。 - 设备ID。 "00000000-0000-0000-0000-000000000000" ip-pool-name 是 string 1~128个字节。 - Key，名称。 "pool1" HTTP的示例 PUT /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-dhcpv4:global-ip-pool/pool1 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "huawei-nce-e-dhcpv4:global-ip-pool" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "gateway-list" : [ { "gateway-ip" : "192.168.1.1", "mask" : 24 } ], "section" : [ { "section-index" : 1, "start-ip" : "192.168.10.1", "end-ip" : "192.168.10.100" } ], "dns-list" : [ { "dns-ip" : "192.168.100.1" } ], "excluded-ip-address" : [ { "start-ip-address" : "192.168.10.10", "end-ip-address" : "192.168.10.120" } ], "static-bind" : [ { "static-bind-ip" : "192.168.100.1", "static-bind-mac" : "01-01-01-01-01-01" } ], "option" : [ { "option-code" : 7, "ip-addresses" : [ u'"192.168.1.1"' ] , "ascii-string" : "test", "hex-string" : "00", "cipher-string" : "Example@123", "sub-options" : { "sub-option" : [ { "sub-option-code" : 1, "ascii-string" : "test" } ] } } ], "ip-pool-name" : "pool1", "vpn-instance" : "overlay_vpn", "network-ipv4-address" : "192.168.10.1", "network-mask" : 24, "domain-name" : "test.com" } ] }

示例：修改指定ip-pool-name为pool1和section-index为1的section URI: /restconf/v2/data/huawei-ac-nes-device:nes/ne/{ neId }/huawei-nce-e-dhcpv4:global-ip-pool/ pool1/1 Table1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 36个字节。满足正则表达[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}。 - 设备ID。 "00000000-0000-0000-0000-000000000000" ip-pool-name 是 string 1~128个字节。 - Key，名称。 "pool1" section-index 是 int64 [0-255] - Key，序号。 1 HTTP的示例 PUT /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-dhcpv4:global-ip-pool/pool1/1 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "huawei-nce-e-dhcpv4:section" : [ { "section-index" : 1, "start-ip" : "192.168.10.1", "end-ip" : "192.168.10.100 } ] }

示例：批量修改DHCP地址池 URI: /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-dhcpv4:global-ip-pool 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 36个字节。满足正则表达[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}。 - 设备ID。 "00000000-0000-0000-0000-000000000000" 请求示例 HTTP的示例 PUT /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-dhcpv4:global-ip-pool HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "huawei-nce-e-dhcpv4:global-ip-pool" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "gateway-list" : [ { "gateway-ip" : "192.168.1.1", "mask" : 24 } ], "section" : [ { "section-index" : 1, "start-ip" : "192.168.10.1", "end-ip" : "192.168.10.100" } ], "dns-list" : [ { "dns-ip" : "192.168.10.1" } ], "excluded-ip-address" : [ { "start-ip-address" : "192.168.10.110", "end-ip-address" : "192.168.10.120" } ], "static-bind" : [ { "static-bind-ip" : "192.168.10.1", "static-bind-mac" : "01-01-01-01-01-01" } ], "option" : [ { "option-code" : 7, "ip-addresses" : [ u'"192.168.10.1"' ] , "ascii-string" : "test", "hex-string" : "00", "cipher-string" : "Example@123", "sub-options" : { "sub-option" : [ { "sub-option-code" : 1, "ascii-string" : "test" } ] } } ], "ip-pool-name" : "pool1", "vpn-instance" : "overlay_vpn", "network-ipv4-address" : "192.168.10.0", "network-mask" : 24, "domain-name" : "test.com" } ] }

URL规则 开放可编程接口中各业务模块的URL支持拼接，手册中仅给出常用的URL，其他URL可通过如下规则进行拼接： 请求格式： 推荐使用/restconf/v2前缀的接口： /restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/{moduleName}/{xxx} 不推荐使用/restconf/v1前缀的接口： /restconf/v1/data/huawei-ac-nes-device:nes/ne/[neId]/{moduleName}/{xxx} /restconf/v2和/restconf/v1接口前缀的区别： 表1 请求类型 /restconf/v2 /restconf/v1 GET 支持：查询指定对象的接口 支持：查询指定对象的接口 POST 支持：创建接口，如果对象已经存在，创建失败 支持：创建接口，如果对象已经存在，创建失败 PUT 支持：全量更新接口，字段不传会被删除 支持：增量更新接口，字段不传不会被删除 DELETE 支持：删除接口，删除指定对象，如果对象不存在，返回数据不存在 支持：删除接口，删除指定对象，如果对象不存在，返回数据不存在 PATCH 支持：增量更新接口，字段不传不会被删除 不支持 请求参数：/restconf/v2和/restconf/v1接口的请求参数逻辑均相同 neId：设备id moduleName：模块名称，各业务模块的模块名请参考各章节 xxx：取值说明如下： 不填写，对整个模块进行操作。 API手册中，标识为必填的字段，使用字段值进行拼接；没有标识为必填的字段，使用字段名拼接。 {xxx}可以支持16个层级，即： /restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/{moduleName}/{xxx} /restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/{moduleName}/{xxx}/{xxx} /restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/{moduleName}/{xxx}/{xxx}/{xxx} … /restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/{moduleName}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx}/{xxx} 示例：以route-policy为例，假设route-policy的数据如下： { "huawei-nce-e-route-policy:route-policy": [ { "name": "policy1", "nodes": [ { "sequence": 1, "match-mode": "permit", "condition": { "community-filter": [ { "community-filter-name": "communityFilterName1" } ], "ext-community-filter": [ { "ext-community-filter-name": "extCommunityFilterName1" } ] } } ] } ] } 不填写{xxx}。 URL为：/restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-route-policy:route-policy，其中PUT的请求体可参考GET的返回结果，“huawei-nce-e-route-policy:route-policy”为数组，可包含多个元素，示例如下： { "huawei-nce-e-route-policy:huawei-nce-e-route-policy:route-policy": [ { "name": "policy1", "nodes": [ { "sequence": 1, "match-mode": "permit", "condition": { "community-filter": [ { "community-filter-name": "communityFilterName1" } ], "ext-community-filter": [ { "ext-community-filter-name": "extCommunityFilterName1" } ] } } } ] },{ "name": "policy2", "nodes": [ { "sequence": 1, "match-mode": "permit", "condition": { "community-filter": [ { "community-filter-name": "communityFilterName1" } ], "ext-community-filter": [ { "ext-community-filter-name": "extCommunityFilterName1" } ] } } } ] } ] } 假设文档中已说明参数名称为“name”，对应参数说明为“必填字段” 拼接时使用name的值拼接，URL为：/restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/huawei-nce-e-route-policy:route-policy/policy1，其中PUT的请求体可参GET的返回结果，“huawei-nce-e-route-policy:route-policy”为数组，但仅能包含“name”为“policy1”的一个元素，示例如下： { "huawei-nce-e-route-policy:huawei-nce-e-route-policy:route-policy": [ { "name": "policy1", "nodes": [ { "sequence": 1, "match-mode": "permit", "condition": { "community-filter": [ { "community-filter-name": "communityFilterName1" } ], "ext-community-filter": [ { "ext-community-filter-name": "extCommunityFilterName1" } ] } } ] } ] } 假设文档中已说明参数名称为“nodes”对应的参数说明非“必填字段”，拼接时使用字段名nodes拼接，URL为：/restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/huawei-nce-e-route-policy:route-policy/policy1/nodes，其中PUT的请求体可参GET的返回结果，“huawei-nce-e-route-policy:nodes”为数组，可包含多个元素，示例如下： { "huawei-nce-e-route-policy:nodes": [ { "sequence": 1, "match-mode": "permit", "condition": { "community-filter": [ { "community-filter-name": "communityFilterName1" } ], "ext-community-filter": [ { "ext-community-filter-name": "extCommunityFilterName1" } ] } }, { "sequence": 2, "match-mode": "permit", "condition": { "community-filter": [ { "community-filter-name": "communityFilterName1" } ], "ext-community-filter": [ { "ext-community-filter-name": "extCommunityFilterName1" } ] } } ] } 假设文档中已说明参数名称为“sequence”，对应的参数说明为“必填参数”。 拼接时使用“sequence”的值拼接，URL为：/restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/huawei-nce-e-route-policy:route-policy/policy1/nodes/1，其中PUT的请求体可参GET的返回结果，“huawei-nce-e-route-policy:nodes”为数组，但仅能包含“sequence”为1的一个元素： { "huawei-nce-e-route-policy:nodes": [ { "sequence": 1, "match-mode": "permit", "condition": { "community-filter": [ { "community-filter-name": "communityFilterName1" } ], "ext-community-filter": [ { "ext-community-filter-name": "extCommunityFilterName1" } ] } } ] } 假设文档中已说明参数名称为“match-mode”，参数说明不是“必填字段”。 拼接时使用字段名“match-mode”拼接，URL为：/restconf/v2/data/huawei-ac-nes-device:nes/ne/[neId]/huawei-nce-e-route-policy:route-policy/policy1/nodes/1/match-mode，其中PUT的请求体可参GET的返回结果为： { "huawei-nce-e-route-policy:match-mode": "permit" } 父主题： 使用说明

管理工单任务 关于工单任务 工单任务是系统根据抄表计划按一定的时间周期自动生成的计划任务。每个工单任务均包含了一定数量待录入的“工单”，每张待录入的“工单”即代表一个需要录入读数的表计。抄表任务中所有被指定作为执行对象的用户将共同完成一个任务，当任务中所有工单均录入完毕后该任务将自动关闭。 工单任务的状态共分为三种：进行中、逾期及已关闭。在工单任务计划的抄表时间范围内，工单任务的状态属于“进行中”。若当前时间超过了计划抄表时间，则任务自动变更状态为“逾期”，但不影响用户的抄表，可继续录入工单数据。只有当任务中的工单全部完成，或管理人员在PC管理端主动关闭任务时，工单任务状态方可变更为“已关闭”。 管理工单任务：工作人员除了可以使用能耗管理APP用户端根据工单任务进行抄表外，管理人员也可以通过PC管理端查看及管理工单任务。可执行的操作包括： 记录读数：对于尚未记录的工单，管理人员可以直接在后台录入。对单个工单单击“记录读数”即可基于当前时间录入读数。 修改读数：对于已记录的工单，管理人员可以直接在后台修改工单读数。实际上修改工单读数就是修改此工单对应的抄表记录数据。关于更多表计读数记录的说明请浏览查看及修改表计读数。 关闭任务：对于尚存在未记录工单的任务，管理人员可以主动关闭任务，使任务状态变更为“已关闭”。 图3 查看抄表任务

域名 置信度与风险值使用说明 域名置信度与风险值使用说明如图1所示。 图1 域名置信度与风险值使用说明 判断域名是否满足域名规范。 如果是，则执行下一步。 如果不是，则参考其他信息进行处理。 调用威胁信息服务的接口获取域名威胁信息结果。 根据查询结果执行相应动作。 如果查询到数据，则执行下一步。 如果没有查询到数据，则参考其他信息进行处理。 判断域名是否是常用公共基础设施，如含有Name Server、CDN、Whitelist标签。 如果是，则放行此域名。 如果不是，则执行下一步。 判断是否含有其他中性标签，中性标签请参见IP和域名威胁信息标签。 如果是，则根据用户实际情况结合威胁信息接口中其他数据进行人工研判。 如果不是，则执行下一步。 判断置信度是否大于等于90，风险值是否大于60。 如果是，则阻断此域名。 如果不是，则根据用户实际情况结合威胁信息接口中其他数据进行人工研判。 父主题： 置信度与风险值使用说明

建表语法 create table test_mm_tb ( id int, name varchar(30) DEFAULT NULL, create_time datetime DEFAULT NULL, primary key(id)) ENGINE=InnoDB DEFAULT CHARSET=utf8 dbpartition by MOD_HASH(id) tbpartition by MM(create_time) tbpartitions 12;

黑板 黑板是 WeLink 互动教学平台（IdeaRoom）提供的智能黑板书写工具。 黑板书写 点击控制bar“黑板”菜单，即进入黑板界面，使用触摸笔即可开始书写。在底部的功能bar上，用户可以点击对应图标进行设置（黑板背景和主题）、画笔粗细、画笔颜色等切换。 双人书写 开启双人书写后，黑板支持多人同时书写，可应用多人写作业等场景中。 上一步、下一步 在书写过程中，用户可以根据需要执行返回上一步和前进到一步，对黑板书写内容进行快捷修改。 背景 如下图红圈所示，点击即可更换黑板背景和主题。目前黑板提供3种黑板背景（黑色、白色、绿色）和若干种黑板主题（坐标轴、四线三格、田字格、米字格等）。 翻页、加页 当需要增加黑板页码，点击“+”即可实现加页，满足多页面书写。 保存 当需要保存黑板书写内容时，点击保存，页面弹出扫码保存二维码，用户使用WeLink扫一扫即可保存至WeLink个人云空间。 父主题： 产品使用说明