华为云用户手册

响应示例 返回状态码为200：查询成功的信息。响应体参考TerminalMgrCountResponseDto。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "count" : 1 } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：查询成功的信息。响应体参考TerminalMgrCountResponseDto。 表3 TerminalMgrCountResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息 "" count integer - - 数量。 1 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。

URI /controller/campus/v1/accountservice/terminalmgr/endpoint/device/{deviceId}/count 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 string - - 设备Id。UUID格式 "22fbb5f2-d07e-4710-94ac-7705517ab842" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 terminalType 否 string normal iConnect all all 终端类别：normal-普通传统终端、iConnect-iConnect终端、all所有终端 "normal"

请求示例 HTTP的示例 PUT /v1/networkservice/hierarchy-template/template-groups/00000000-0000-0000-0000-000000000000 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 { "name" : "group1", "description" : "this is template group1" }

响应示例 返回状态码为201：操作成功。 HTTP/1.1 201 Created Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "name" : "group1", "description" : "this is template group1", "id" : "00000000-0000-0000-0000-000000000000", "type" : "preset", "bindingSiteNum" : "", "createTime" : "1713880927744", "updateTime" : "1713880927744" } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" } 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/policy/traffic/woc/policy 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 { "effectImmediate" : true, "wocPolicies" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "WocPolicy", "priority" : 1, "vpnId" : "00000000-0000-0000-0000-000000000000", "optimizationType" : "FEC", "isActive" : true, "status" : 10, "fecData" : { "antiLossType" : "A-FEC", "lossRate" : 1, "blockSize" : 40, "timeout" : 40, "mtu" : 400, "continuousLoss" : 10 }, "compressionData" : { "compressionType" : "LZ4" }, "classifytemplate" : { "id" : "00000000-0000-0000-0000-000000000000", "templateName" : "template" }, "timeTemplate" : { "id" : "00000000-0000-0000-0000-000000000000", "templateName" : "timeTemplate" } } ] }

响应示例 返回状态码为200：修改成功，返回体参考WocPolicyResponse。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ { "id" : "00000000-0000-0000-0000-000000000000", "name" : "WocPolicy", "priority" : 1, "vpnId" : "00000000-0000-0000-0000-000000000000", "optimizationType" : "FEC", "isActive" : true, "status" : 10, "fecData" : { "antiLossType" : "A-FEC", "lossRate" : 1, "blockSize" : 40, "timeout" : 40, "mtu" : 400, "continuousLoss" : 10 }, "compressionData" : { "compressionType" : "LZ4" }, "classifytemplate" : { "id" : "00000000-0000-0000-0000-000000000000", "templateName" : "template" }, "timeTemplate" : { "id" : "00000000-0000-0000-0000-000000000000", "templateName" : "timeTemplate" } } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "name" : "WocPolicy", "priority" : 1, "vpnId" : "00000000-0000-0000-0000-000000000000", "optimizationType" : "FEC", "isActive" : true, "status" : 10, "fecData" : { "antiLossType" : "A-FEC", "lossRate" : 1, "blockSize" : 40, "timeout" : 40, "mtu" : 400, "continuousLoss" : 10 }, "compressionData" : { "compressionType" : "LZ4" }, "classifytemplate" : { "id" : "00000000-0000-0000-0000-000000000000", "templateName" : "template" }, "timeTemplate" : { "id" : "00000000-0000-0000-0000-000000000000", "templateName" : "timeTemplate" } } } ] } 返回状态码为400：请求参数错误，无响应体。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误，无响应体。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

账号基础 登录使用华为乾坤时主要涉及如下账号类型： 华为官网账号 华为官网常见账号类型有： 华为账号 在华为官网注册的账号。该账号可以访问华为云、华为商城等所有华为服务。 华为云账号 2020年12月30日之前在华为云官网注册的账号。该账号是专属账号，仅能登录华为云，无法登录其他华为服务。 为了统一账号，提升登录体验，当前在华为云官网只能 注册华为账号 。 如果您在华为云购买资源后，需要对资源进行精细访问控制，可以在 统一身份认证 （Identity and Access Management， IAM ）服务中创建IAM用户，具体介绍参见《统一身份认证服务》中“华为云IAM简介”章节。 华为账号、华为云账号、IAM用户基本概念和账号间的关系请参见《统一身份认证服务》中“华为云账号介绍”章节。 华为官网账号是用户在华为云资源归属、资源计费的主体，负责统一管理费用。 首次注册的华为账号相当于一级租户管理员，可以创建下级IAM用户并赋予不同的使用权限。 华为乾坤账号 用于登录华为乾坤控制台，是使用云服务的账号。该账号不进行独立计费，由绑定的华为账号统一管理费用。 首次注册的华为乾坤账号相当于一级租户管理员，拥有所有权限，可以继续创建下级租户账号，并对下级租户进行授权。例如为企业不同分支、不同部门创建不同的租户。下级租户授权的详细介绍请参见租户账号管理。 华为乾坤账号分为租户、MSP（渠道服务商）两种账号，租户可以委托MSP代维。本文档不详细介绍MSP账号，具体参见《华为乾坤MSP操作指南》《华为乾坤MSP操作指南》。 华为坤灵账号 仅在办公或家庭等小型网络场景下使用，工程商使用华为坤灵账号通过华为坤灵APP登录华为乾坤控制台，远程运维和业务部署。目前仅支持云管理网络服务中的部分功能。 当前，部分复杂网络功能暂不支持在华为坤灵APP端操作，但是支持在华为乾坤Web端进行操作。Web端支持操作的部分常见功能请参见表1。 表1 Web端支持操作的部分常见功能 分类 常用功能 详细说明 基础配置 远程登录设备Web页面 AR路由器和交换机（S210除外）在华为坤灵系统上线后，支持通过华为乾坤Web端跳转登录到设备Web页面。 LAN侧配置 链路聚合 将多个物理接口捆绑为一个逻辑接口，增加链路带宽，提升链路可靠性。 DHCP Snooping 保证DHCP客户端从合法的DHCP服务器获取IP地址，并记录DHCP客户端IP地址与MAC地址等参数的对应关系，防止网络上针对DHCP攻击。 运维 用户接入信息列表查看 支持查看接入网络的用户摘要信息，包括终端MAC地址、流量、时延、丢包、厂商类型等。 接口性能查看 支持显示接口信息，包括报文、流量、宽带利用率等。 设备日志收集 支持下载设备日志文件。 父主题： 账号准备

响应参数 返回状态码为200：查询成功。 表1 CliSwitchResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表2。 - - 表2 CliSwitchOutDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 cliEnable boolean true false - 设备本地CLI配置开关状态。 false modifiable boolean true false - msp是否授权租户修改设备本地CLI配置开关。当modifiable为false时，需要向MSP申请授权后，才能修改设备本地CLI配置开关。 false

响应示例 返回状态码为200：查询成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "cliEnable" : false, "modifiable" : false } }

请求示例 HTTP的示例 GET /controller/campus/v1/networkservice/networkconfig/net/cliswitch 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

响应示例 返回状态码为200：正常响应返回体，返回的自定义应用信息中仅包含对应的ID。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "processInstanceId" : "", "success" : [ { "id" : "00000000-0000-0000-0000-000000000000", "appName" : "app", "description" : "", "extendApp" : false, "appType" : "", "appGroups" : [ "00000000-0000-0000-0000-000000000000" ], "applicationGroups" : [ { "applicationGroupName" : "", "applicationGroupId" : "" } ], "applicationRules" : [ { "ruleName" : "rule", "ruleId" : "00000000-0000-0000-0000-000000000000", "description" : "tcpRule", "destinationIP" : "10.1.1.1/32", "port" : "1,2,3-20", "protocolType" : "tcp", "signatureEnable" : false, "context" : "flow", "direction" : "request", "plainString" : "abcde", "dscp" : 20, "domain" : "www.example.com", "sourceIp" : "192.168.10.5/32", "sourcePortRange" : "30-50" } ], "configId" : "00000000-0000-0000-0000-000000000000" } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "appName" : "app", "description" : "", "extendApp" : false, "appType" : "", "appGroups" : [ "00000000-0000-0000-0000-000000000000" ], "applicationGroups" : [ { "applicationGroupName" : "", "applicationGroupId" : "" } ], "applicationRules" : [ { "ruleName" : "rule", "ruleId" : "00000000-0000-0000-0000-000000000000", "description" : "tcpRule", "destinationIP" : "10.1.1.1/32", "port" : "1,2,3-20", "protocolType" : "tcp", "signatureEnable" : false, "context" : "flow", "direction" : "request", "plainString" : "abcde", "dscp" : 20, "domain" : "www.example.com", "sourceIp" : "192.168.10.5/32", "sourcePortRange" : "30-50" } ], "configId" : "00000000-0000-0000-0000-000000000000" } } ] } 返回状态码为204：删除成功，响应体参考CustomApplicationResponse。 HTTP/1.1 204 No Content Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为400：请求参数错误。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/application/custom-applications/action/batch-delete 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 { "customApplications" : [ { "id" : "00000000-0000-0000-0000-000000000000", "appName" : "app", "description" : "", "extendApp" : false, "appType" : "", "appGroups" : [ "00000000-0000-0000-0000-000000000000" ], "applicationGroups" : [ { "applicationGroupName" : "", "applicationGroupId" : "" } ], "applicationRules" : [ { "ruleName" : "rule", "ruleId" : "00000000-0000-0000-0000-000000000000", "description" : "tcpRule", "destinationIP" : "10.1.1.1/32", "port" : "1,2,3-20", "protocolType" : "tcp", "signatureEnable" : false, "context" : "flow", "direction" : "request", "plainString" : "abcde", "dscp" : 20, "domain" : "www.example.com", "sourceIp" : "192.168.10.5/32", "sourcePortRange" : "30-50" } ], "configId" : "00000000-0000-0000-0000-000000000000" } ] }

响应示例 返回状态码为200：修改AP VPN配置成功，响应体参考ApVpnResponseDto。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "id" : "e4d2b0e95bb94ef0a75b6a530d0b41be", "ipsecConnectionName" : "vpn1", "deviceName" : "AirEngine6760R-51_FBF792C3", "deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e", "peerAddress" : "192.168.1.1" , "localIdType" : "ip", "localIdValue" : "myhost.example.com", "refinedAcl" : [ { "priority" : 1, "action" : true, "protocol" : "tcp", "sourceIp" : "192.168.1.0/24", "sourceIpPort" : "1000", "desIp" : "192.168.1.0/24", "port" : "1000", "description" : "acl信息" } ], "filterAcl" : [ { "priority" : 1, "action" : true, "protocol" : "tcp", "sourceIp" : "192.168.1.0/24", "sourceIpPort" : "1000", "desIp" : "192.168.1.0/24", "port" : "1000", "description" : "acl信息" } ], "ipsecTemplateId" : "f285e423-492a-41ef-a4b8-5a687fc6832a", "preSharedKey" : "IAm@example" } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部服务错误 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 PUT /controller/campus/api/v1/networkconfig/apvpn 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 { "id" : "e4d2b0e95bb94ef0a75b6a530d0b41be", "ipsecConnectionName" : "vpn1", "deviceName" : "AirEngine6760R-51_FBF792C3", "deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e", "peerAddress" : "192.168.1.1" , "localIdType" : "ip", "localIdValue" : "myhost.example.com", "refinedAcl" : [ { "priority" : 1, "action" : true, "protocol" : "tcp", "sourceIp" : "192.168.1.0/24", "sourceIpPort" : "1000", "desIp" : "192.168.1.0/24", "port" : "1000", "description" : "acl信息" } ], "filterAcl" : [ { "priority" : 1, "action" : true, "protocol" : "tcp", "sourceIp" : "192.168.1.0/24", "sourceIpPort" : "1000", "desIp" : "192.168.1.0/24", "port" : "1000", "description" : "acl信息" } ], "ipsecTemplateId" : "f285e423-492a-41ef-a4b8-5a687fc6832a", "preSharedKey" : "IAm@example" }

响应示例 返回状态码为200：查看当前站点纳管的WAN链路成功，响应体参考QuerySiteManagerLinkResponse。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : [ { "siteId" : "a99f794e-b510-438c-a75d-de59f02347eb", "deviceId" : "a99f794e-b510-438c-a75d-de59f02347cd", "deviceName" : "Device1", "wanLinkId" : "a99f794e-b510-438c-a75d-de59f02347dd", "wanName" : "link1", "protocol" : "IPv4", "interfaceName" : "GigabitEthernet0/0/4", "switchState" : "failed", "reasons" : "连接失败", "linkUpdateState" : "success" } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应示例 返回状态码为200：删除成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：查看当前站点纳管的WAN链路成功，响应体参考QuerySiteManagerLinkResponse。 表2 QuerySiteManagerLinkResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data ARRAY_REFERENCE 0-1000个列表项，详细请参见表3。 当前站点纳管的WAN链路。 - 表3 SiteManagerLinkInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteId UUID - - 站点ID，格式为uuid。 "a99f794e-b510-438c-a75d-de59f02347eb" deviceId UUID - - 设备ID，格式为uuid。 "a99f794e-b510-438c-a75d-de59f02347cd" deviceName string - - 设备名称。 "Device1" wanLinkId string - - 链路ID，格式为uuid。 "a99f794e-b510-438c-a75d-de59f02347dd" wanName string - - WAN链路名称。 "link1" protocol string - - 注册AC链路的协议：IPv4、IPv6。 "IPv4" interfaceName string - - 物理接口名称。 "GigabitEthernet0/0/4" switchState string - - 切换状态。 "failed" reasons string - - 失败原因。 "连接失败" linkUpdateState string - - 链路更新状态。该字段已废弃。 "success" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/net/site-manage-link?siteId=a99f794e-b510-438c-a75d-de59f02347eb&deviceId=a99f794e-b510-438c-a75d-de59f02347cd 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

请求示例 HTTP的示例 DELETE /controller/campus/v1/networkservice/networkconfig/net/lswglobalvlan/devices/ffce359c-cf08-4717-bc26-c6e6af8f0ec3/globalvlan/813a76d4-6eec-4264-ae45-a6f261482b60 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

URI /controller/campus/v1/networkservice/networkconfig/net/lswglobalvlan/devices/{deviceId}/globalvlan/{recordId} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 string - - 设备ID, UUID格式。 "ffce359c-cf08-4717-bc26-c6e6af8f0ec3" recordId 是 string - - VlanId，UUID格式。 "813a76d4-6eec-4264-ae45-a6f261482b60"

URI /controller/campus/v1/sdwan/net/site-manage-link 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 否 UUID - - 站点ID，格式为uuid，站点ID和设备ID至少有一个。 "a99f794e-b510-438c-a75d-de59f02347eb" deviceId 否 UUID - - 设备ID，格式为uuid，站点ID和设备ID至少有一个。 "a99f794e-b510-438c-a75d-de59f02347cd"

URI /controller/campus/v1/networkservice/networkconfig/site-template-binding-relationship/{siteTemplateId}/batch-delete 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板ID，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e451"

请求示例 HTTP的示例 POST /controller/campus/v1/networkservice/networkconfig/site-template-binding-relationship/fbde1c5d-5b94-49e3-a912-48641015e451/batch-delete 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 { "siteIds" : [ "4f350825-919c-47b7-b853-f51f15912396" ] }

响应示例 返回状态码为200：解绑成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ "4f350825-919c-47b7-b853-f51f15912396" ], "fail" : [ { "errcode" : "0x00c80035", "errmsg" : "Invalid parameter.", "data" : "4f350825-919c-47b7-b853-f51f15912396" } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部服务错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应示例 返回状态码为200：查询成功，响应体参考TerminalPrivacyList。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "pageIndex" : 1, "pageSize" : 20, "total" : 100, "terminalPrivacy" : [ { "id" : "b9b34988-0dff-4def-9e55-7bc0b3dc21b4", "policyName" : "TenantPolicy", "storageTime" : "30", "dataMasking" : "false", "isEnable" : "false" } ] } 返回状态码为400：查询失败，参数校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：查询失败，服务内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：查询成功，响应体参考TerminalPrivacyList。 表2 TerminalPrivacyList对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。当没有错误时返回0。 "0" errmsg string - - 错误信息。当没有错误时返回""。 "" pageIndex int32 - - 页码。 1 pageSize int32 - - 页长。 20 total int32 - - 策略总数。 100 terminalPrivacy ARRAY_REFERENCE 0-100个列表项，详细请参见表3。 终端隐私策略。 - 表3 TerminalPrivacy对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 策略ID。 "b9b34988-0dff-4def-9e55-7bc0b3dc21b4" policyName string - - 策略名称。该字段对应UI界面上是：UI【策略名称】 "TenantPolicy" storageTime int32 - - 终端接入记录存储时间，单位：天。 "30" dataMasking boolean true false - 终端信息匿名化。该字段对应UI界面上是：UI【终点信息匿名化】 "false" isEnable boolean true false - 策略是否启用。该字段对应UI界面上是：UI【策略是否启用】 "false" 返回状态码为400：查询失败，参数校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：查询失败，服务内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 GET /controller/campus/api/v1/terminal-privacy?policyType=TENANT&pageIndex=1&pageSize=10 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

URI /controller/campus/api/v1/terminal-privacy 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 policyType 是 string - - 终端隐私设置策略类型， 该字段可以设置为以下几种： a) TENANT:租户级 b) SITE:站点级 "TENANT" pageIndex 否 int32 - 1 页码，该字段的取值范围是：1-2147483647。 1 pageSize 否 int32 [10-100] 10 页长，该字段的取值范围是：10-100。 10

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/apextraservice/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/apextraservices 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 { "mu" : true, "serverIp" : "www.example.com", "serverPort" : 10020, "interver" : 10000, "rssi" : -80, "apLocationEnable" : true, "apLocation" : "B2-5F-01", "enablePsk" : false }