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

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/policy/traffic/device/qos?deviceId=00000000-0000-0000-0000-00000000000 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

响应参数 返回状态码为200：正常响应返回体，返回的设备QoS带宽统计开销设置信息中仅包含对应的deviceId。 QosDeviceResponse对象的参数列表，详细请参见表4。 返回状态码为202：请求正在处理中，请求处理详情请通过“查询业务编排结果”接口，确认是否处理成功。响应体参考QosDeviceResponse。 返回状态码为204：删除成功，响应体参考QosDeviceResponse。 返回状态码为400：请求参数错误，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误，无响应体。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：正常响应返回体，返回的设备QoS带宽统计开销设置信息中仅包含对应的deviceId。 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" : [ { "deviceId" : "00000000-0000-0000-0000-00000000000", "qosOverHead" : "link" } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid", "data" : { "deviceId" : "00000000-0000-0000-0000-00000000000", "qosOverHead" : "link" } } ], "processInstanceId" : "" } 返回状态码为202：请求正在处理中，请求处理详情请通过“查询业务编排结果”接口，确认是否处理成功。响应体参考QosDeviceResponse。 HTTP/1.1 202 Accepted 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 返回状态码为204：删除成功，响应体参考QosDeviceResponse。 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/policy/traffic/device/qos/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 { "deviceIds" : [ "00000000-0000-0000-0000-00000000000" ] }

请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/policy/traffic/device/qos 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 { "qosPolicies" : [ { "deviceId" : "00000000-0000-0000-0000-00000000000", "qosOverHead" : "link" } ] }

响应示例 返回状态码为200：配置成功，响应体参考QosDeviceResponse。 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" : [ { "deviceId" : "00000000-0000-0000-0000-00000000000", "qosOverHead" : "link" } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid", "data" : { "deviceId" : "00000000-0000-0000-0000-00000000000", "qosOverHead" : "link" } } ], "processInstanceId" : "" } 返回状态码为202：请求正在处理中，请求处理详情请通过“查询业务编排结果”接口，确认是否处理成功。响应体参考QosDeviceResponse。 HTTP/1.1 202 Accepted 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 返回状态码为204：执行成功，无响应体。 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

响应参数 返回状态码为200：配置成功，响应体参考QosDeviceResponse。 表4 QosDeviceResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" success ARRAY_REFERENCE 0-100个列表项，详细请参见表3。 成功的设备QoS带宽统计开销设置信息列表。 - fail ARRAY_REFERENCE 0-100个列表项，详细请参见表5。 失败的设备QoS带宽统计开销设置信息列表。 - processInstanceId string 0~36个字符。 - 编排流程实例ID，UUID格式。当接口返回码为202时非空。 - 表5 FailQosDeviceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0x00c8000c" errmsg string - - 错误信息。 "The parameter is invalid" data REFERENCE 详细请参见表3。 失败的设备QoS带宽统计开销设置详细信息。 - 返回状态码为202：请求正在处理中，请求处理详情请通过“查询业务编排结果”接口，确认是否处理成功。响应体参考QosDeviceResponse。 返回状态码为204：执行成功，无响应体。 返回状态码为400：请求参数错误，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误，无响应体。 详细信息请参见实际响应消息体。

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 qosDeviceInfos 是 REFERENCE 详细请参见表2。 配置设备QoS带宽统计开销请求数据。 - 表2 QosDeviceInfos对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 qosPolicies 否 ARRAY_REFERENCE 1-100个列表项，详细请参见表3。 设备QoS带宽统计开销设置详细信息。 - 表3 QosDeviceInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 uuid - - 设备ID，UUID格式。 "00000000-0000-0000-0000-00000000000" qosOverHead 是 string 4~7个字符。 - 设备QoS带宽统计开销设置类型，该字段可以设置为以下几种： a) link：仅包括报文的链路层 b) physics：包括报文的物理层和链路层 "link"