华为云用户手册

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-route-policy:route-policy 表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"

响应示例 返回状态码为200：修改成功，响应体参考QosWredProfileResponse。 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" : { "name" : "wred1", "fullReplace" : false, "dscpInfos" : [ { "wredMode" : 1, "value" : 10, "lowLimit" : 10, "highLimit" : 10, "percentage" : 10 } ], "id" : "00000000-0000-0000-0000-000000000000" } } 返回状态码为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

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 qosWredProfile 是 REFERENCE 详细请参见表2。 修改建QoS Wred模板请求数据。 - 表2 WredProfileInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 否 string 1~31个字符。满足正则表达^[a-zA-Z0-9_-]+$。 - WRED名称只能包括字母、数字、横线、和下划线。 "wred1" fullReplace 否 boolean true false false 是否全量替换,为true时表示全量接口，为false时表示增量接口，只在更新时生效，其他操作忽略。 false dscpInfos 否 ARRAY_REFERENCE 0-64个列表项，详细请参见表3。 DSCP信息。 - id 是 uuid - - 模板ID。 "00000000-0000-0000-0000-000000000000"

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/policy/traffic/qos/wred-profile 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" : "wred1", "fullReplace" : false, "dscpInfos" : [ { "wredMode" : 1, "value" : 10, "lowLimit" : 10, "highLimit" : 10, "percentage" : 10 } ], "id" : "00000000-0000-0000-0000-000000000000" }

请求示例 HTTP的示例 POST /controller/campus/v1/networkservice/networkconfig/site-templates 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 { "name" : "siteTemplate1", "types" : [ "AP" ], "custom" : true, "parentId" : "fbde1c5d-5b94-49e3-a912-48641015e451", "configIdentifies" : [ "snmp" ] }

响应示例 返回状态码为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 { "errcode" : "0", "errmsg" : "", "data" : { "id" : "fbde1c5d-5b94-49e3-a912-48641015e451", "name" : "siteTemplate1", "types" : [ "AP" ], "capabilities" : ["AP","FW","LSW"], "custom" : true, "configIdentifies" : "snmp" } } 返回状态码为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

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-route-policy:route-policy/{name} 表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" name 是 string 1~200个字符。 - 名称，单一主键字段。 "policy1"

请求示例 HTTP的示例 PUT /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-route-policy:route-policy/policy1 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 restconf-transaction-id: "00000000-0000-0000-0000-000000000000" { "huawei-nce-e-route-policy:route-policy" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "name" : "policy1", "nodes" : [ { "sequence" : 1, "match-mode" : "permit", "condition" : { "match-tag" : 1, "match-ipv4-type" : "ipv4-prefix", "match-ipv4-prefix" : "prefix1", "match-ipv6-type" : "ipv6-prefix", "match-ipv6-prefix" : "prefix1", "community-filter" : [ { "community-filter-name" : "communityFilterName1" } ], "ext-community-filter" : [ { "ext-community-filter-name" : "extCommunityFilterName1" } ] }, "action" : { "apply-tag" : 10, "apply-cost" : 10, "apply-local-preference" : 10, "apply-ext-community-color" : "100", "apply-community" : { "operation" : "replace", "set-community-type" : "inline", "communities" : [ "1:1" ] }, "apply-ext-community" : { "operation" : "replace", "ext-community-member" : [ { "value" : "1:1" } ] } } } ] } ] }

响应示例 返回状态码为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 返回状态码为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

请求参数 表2 header参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 restconf-transaction-id 是 string - - 事务ID。 "00000000-0000-0000-0000-000000000000" 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-route-policy:route-policy 是 REFERENCE 详细请参见表4。 路由策略配置参数。 -

响应示例 返回状态码为200：接口调用成功，响应体参考QueryExternalPortResponse。 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" : "", "totalRecords" : 200, "pageSize" : 20, "pageIndex" : 1, "data" : [ { "id" : "fbb684c8-0d37-496f-bafa-4b06d515a7l6", "name" : "Connect to PE", "siteId" : "fbb684c8-0d37-496f-bafa-4b06d515a7l6", "deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515a7l6", "portId" : "fbb684c8-0d37-496f-bafa-4b06d515a7l6", "isSubInterface" : true, "vlanId" : 2, "isEnableMpls" : true, "ipConnection" : { "ipv4" : { "ipMode" : "Static", "customerAddress" : "192.168.0.1", "prefixLength" : 24 } }, "attributes" : { "mtu" : 1500, "TCPmss" : 1200 }, "description" : "" } ] } 返回状态码为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的示例 GET /controller/campus/v1/sdwan/overlay-network/external-ports?pageIndex=1&pageSize=20&sort=name&siteId=a99f794e-b510-438c-a75d-de59f02347eb&id=a99f794e-b510-438c-a75d-de59f02347eb 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：接口调用成功，响应体参考QueryExternalPortResponse。 表2 QueryExternalPortResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 200 pageSize int32 - - 每页显示数量。 20 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表8。 外部接口信息。 - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

URI /controller/campus/v1/sdwan/overlay-network/external-ports 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 否 int32 [0-65535] 1 当前页数，默认是1。 1 pageSize 否 int32 [0-65535] 20 每页显示数量，默认是20，当为空或者为0时，表示不使用。 20 sort 否 string 0~255个字符。 - 排序字段，默认情况下不排序，未使用。 "name" siteId 否 uuid - - 站点ID，不指定外部接口ID时，必须指定。格式是uuid。 "a99f794e-b510-438c-a75d-de59f02347eb" id 否 uuid - - 外部接口ID。格式是uuid。 "a99f794e-b510-438c-a75d-de59f02347eb"

响应示例 返回状态码为200：创建成功，响应体参考NatResponse。 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" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "policyId" : "00000000-0000-0000-0000-000000000000", "policyName" : "test name", "globalStartAddress" : "192.168.1.1", "globalEndAddress" : "192.168.1.2", "insideStartAddress" : "192.168.1.1", "insideEndAddress" : "192.168.1.2", "globalSourcePort" : "1", "globalEndPort" : "2", "insideSourcePort" : "1", "insideEndPort" : "2", "protocol" : "6", "reverse" : true, "interfaceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "GE0/0/0" } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "errparam" : "["policyName"]", "data" : { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "policyId" : "00000000-0000-0000-0000-000000000000", "policyName" : "test name", "globalStartAddress" : "192.168.1.1", "globalEndAddress" : "192.168.1.2", "insideStartAddress" : "192.168.1.1", "insideEndAddress" : "192.168.1.2", "globalSourcePort" : "1", "globalEndPort" : "2", "insideSourcePort" : "1", "insideEndPort" : "2", "protocol" : "6", "reverse" : true, "interfaceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "GE0/0/0" } } ] }

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表2。 NAT Server策略信息。 - 表2 NatServerInfos对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 natServerInfos 否 ARRAY_REFERENCE 0-64个列表项，详细请参见表3。 NAT Server的详细信息。 - 表3 NatServerInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 vpnId 否 string 0~36个字符。 - VPN业务ID，创建时必填。 Overlay，填写WAN虚拟网络ID； Underlay，填写“UnderlayId”。 "00000000-0000-0000-0000-000000000000" siteId 否 string 0~64个字符。 - 站点ID，创建时必填。 "00000000-0000-0000-0000-000000000000" deviceId 否 string 0~64个字符。 - 设备ID，创建时必填。 "00000000-0000-0000-0000-000000000000" policyId 否 string 0~64个字符。 - 策略ID，创建时不需要填写，修改时必填。 "00000000-0000-0000-0000-000000000000" policyName 否 string 0~64个字符。 - 策略名称，创建时必填。 "test name" globalStartAddress 否 string 0~20个字符。 - 服务器映射的公网起始地址，修改场景需要指定。 "192.168.1.1" globalEndAddress 否 string 0~20个字符。 - 服务器映射的公网结束地址，修改场景需要指定。 "192.168.1.2" insideStartAddress 否 string 0~20个字符。 - 服务器映射的私网起始地址，修改场景需要指定。 "192.168.1.1" insideEndAddress 否 string 0~20个字符。 - 服务器映射的私网结束地址，修改场景需要指定。 "192.168.1.2" globalSourcePort 否 int32 [0-65535] - 公网起始端口，修改场景需要指定。 "1" globalEndPort 否 int32 [0-65535] - 公网结束端口，修改场景需要指定。 "2" insideSourcePort 否 int32 [0-65535] - 私网起始端口，修改场景需要指定。 "1" insideEndPort 否 int32 [0-65535] - 私网结束端口，修改场景需要指定。 "2" protocol 否 string 满足正则表达1|6|17|41|47|50|51|132。 - 报文协议类型，包括1(ICMP)、6(TCP)、17(UDP)、41(IPv6)、47(GRE)、50(ESP)、51(AH)、132(SCTP)。 "6" reverse 否 boolean true false true 创建反向server-map。默认值为true。 true interfaceId 否 string 0~64个字符。 - 接口id,Overlay 目的NAT SASE场景不支持配置接口ID。 "00000000-0000-0000-0000-000000000000" interfaceName 否 string 0~64个字符。 - 接口名称，Overlay 目的NAT SASE场景不支持配置接口名称。 "GE0/0/0"

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/policy/traffic/nat/natserver 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 { "natServerInfos" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "policyId" : "00000000-0000-0000-0000-000000000000", "policyName" : "test name", "globalStartAddress" : "192.168.1.1", "globalEndAddress" : "192.168.1.2", "insideStartAddress" : "192.168.1.1", "insideEndAddress" : "192.168.1.2", "globalSourcePort" : "1", "globalEndPort" : "2", "insideSourcePort" : "1", "insideEndPort" : "2", "protocol" : "6", "reverse" : true, "interfaceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "GE0/0/0" } ] }

响应参数 返回状态码为200：站点内HACA模板绑定信息，响应体参考HacaBindInfoResponse。 表2 HacaBindInfoResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" total int32 [0-100000] - 总数。 35 data ARRAY_REFERENCE 0-64个列表项，详细请参见表3。 返回消息体的具体信息 - 表3 DeviceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 32~36个字符。 - 设备id。 "55fc4f3b-4f20-48c9-ab4c-28a281384ce1" deviceName string 0~128个字符。 - 设备名称。 "device11" deviceEsn string 0~64个字符。 - 设备ESN。 "0002353AJS0000000000" deviceModel string 0~512个字符。 - 设备型号。 "S6730-H24X6C" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：站点内HACA模板绑定信息，响应体参考HacaBindInfoResponse。 HTTPS 200 OK Date: Thu,13 Sep 2022 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode":"0", "errmsg":"", "total":1, "data": [ { "id": "55fc4f3b-4f20-48c9-ab4c-28a281384ce1", "deviceName": "设备1", "deviceEsn": "0002353AJS0000000000", "deviceModel": "S6730-H24X6C" } ] } 返回状态码为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的示例 GET /controller/campus/api/campusaccesscfgservice/v1/lswauth/haca/bind?templateId=ca3c4f3b-4f20-48c9-ab4c-28a281384795&pageIndex=1&pageSize=10&sort=-deviceName&keyword=test 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/campusaccesscfgservice/v1/lswauth/haca/bind 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 templateId 否 string 32~36个字符。 - 模板id。 "ca3c4f3b-4f20-48c9-ab4c-28a281384795" pageIndex 否 int32 [1-100000] - 当前页码。 1 pageSize 否 int32 [5-200] - 分页大小。 10 sort 否 string 0~128个字符。 - 排序。deviceName/-deviceName "-deviceName" keyword 否 string 0~32个字符。 - 关键字，支持按设备名称过滤 "test"

硬件安装云化设备 根据部署规划时的网络设备安装点位设计、设备间互联等信息，完成网络设备的硬件安装、连线、上电等操作，参见表1。 表1 硬件安装与布线任务一览表 任务 任务说明 参考链接 安装硬件设备 硬件设备安装需要遵循施工规范，常见的硬件施工规范有： 物理设备必须可靠接地。 物理设备谨慎搬运，要连带外纸箱或泡沫垫，不要裸机搬运。 所有光纤、网线、高速电缆和电源线分开布线，规范折弯有序捆扎。 所有光纤、网线和电源线需要考虑长度和传输距离是否能够满足环境的需求。 请单击以下设备名称，进入“硬件安装与维护指南”手册，查看对应设备款型的安装指导。 若无法找到，请在搜索框中输入设备款型查找安装指导。 防火墙 交换机 AP 连接线缆 根据布线规划完成线缆连接，连接时注意按照规范在线缆两端打上标签。 设备配电、上电 请按照规划的配电参数和各个产品的产品文档来执行设备上电操作。

响应示例 返回状态码为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 { "huawei-nce-e-nat-if:nat-if" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "if-name" : "GE0/0/3", "nat-enable" : true } ] } 返回状态码为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

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-nat-if:nat-if/{if-name} 表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" if-name 是 string 1~63个字符。 - Interface name. "GE0/0/3"

请求示例 HTTP的示例 GET /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-nat-if:nat-if/GE0%2F0%2F3 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 restconf-transaction-id: "00000000-0000-0000-0000-000000000000"

请求示例 HTTP的示例 POST /v1/perfservice/alarms/shield-alarms/white-list 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 { "alarmIds" : [ "" ] }

响应参数 返回状态码为200：创建告警屏蔽规则成功后的状态返回码。 表3 CommonOut对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~256个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" 返回状态码为400：接口入参非法的状态返回码。 详细信息请参见实际响应消息体。 返回状态码为500：接口发生内部错误后的状态返回码。 详细信息请参见实际响应消息体。

响应示例 返回状态码为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 返回状态码为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：查询成功，响应体参考QueryQosDeviceResponse。 表2 QueryQosDeviceResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 10 pageSize int32 - - 分页大小。 10 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表3。 设备QoS带宽统计开销设置信息。 - 表3 QosDeviceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId uuid - - 设备ID，UUID格式。 "00000000-0000-0000-0000-00000000000" qosOverHead string 4~7个字符。 - 设备QoS带宽统计开销设置类型，该字段可以设置为以下几种： a) link：仅包括报文的链路层 b) physics：包括报文的物理层和链路层 "link" 返回状态码为400：请求参数错误，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误，无响应体。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：查询成功，响应体参考QueryQosDeviceResponse。 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" : "", "totalRecords" : 10, "pageSize" : 10, "pageIndex" : 1, "data" : [ { "deviceId" : "00000000-0000-0000-0000-00000000000", "qosOverHead" : "link" } ] } 返回状态码为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