设置网络控制策略v3
更新时间 2026-11-09 14:59:08
最近更新时间: 2026-11-09 14:59:08
接口功能介绍
设置指定基础策略的网络访问、互访及协议通道带宽控制配置。
接口约束
无
URI
POST /v3/strategy/networkControl
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| strategyOid | 是 | String | 策略Oid。 | ||
| cloudDesktopInternetAccessEnable | 是 | Boolean | 是否允许该策略下的云电脑访问互联网。 | ||
| desktopNetworkInterworkingEnable | 是 | Boolean | 是否允许同一策略下的云电脑之间互访。 | ||
| clientInternetConnectivity | 是 | String | 客户端访问互联网策略。可能值： - ALLOW：允许。 - DENY：禁止。 - INHERIT：继承上级配置。 | ||
| clientCloudLineConnectivity | 是 | String | 客户端访问云专线策略。可能值： - ALLOW：允许。 - DENY：禁止。 - INHERIT：继承上级配置。 | ||
| bandwidthControl | 是 | Object | 协议通道带宽控制配置。 启用时必须提交全部带宽值。 关闭时不得提交带宽值。 | bandwidthControl |
表 bandwidthControl
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| enable | 是 | Boolean | 是否启用带宽控制。 | ||
| usbBandwidthKB | 否 | Integer | USB重定向双向带宽上限。 入、出方向使用同一值。 单位KB/s，取值500~20000。 启用带宽控制时必填。 | ||
| cameraBandwidthKB | 否 | Integer | 摄像头重定向带宽上限。 单位KB/s，取值500~20000。 启用带宽控制时必填。 | ||
| fileDragBandwidthKB | 否 | Integer | 文件拖拽双向带宽上限。 拖入、拖出使用同一值。 单位KB/s，取值500~20000。 启用带宽控制时必填。 | ||
| fileRedirectionBandwidthKB | 否 | Integer | 文件重定向双向带宽上限。 入、出方向使用同一值。 单位KB/s，取值500~20000。 启用带宽控制时必填。 | ||
| printerBandwidthKB | 否 | Integer | 打印机重定向带宽上限。 单位KB/s，取值500~20000。 启用带宽控制时必填。 | ||
| networkRedirectionBandwidthKB | 否 | Integer | 网络重定向双向带宽上限。 端侧、云侧和入、出方向 使用同一值。 单位KB/s，取值1024~20000。 启用带宽控制时必填。 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码，800表示请求成功，900表示请求失败。 | 800 | |
| error | String | 错误码。 | ECPC_1000 | |
| message | String | 提示信息。 | OK. | |
| returnObj | Boolean | 是否设置成功。 |
枚举参数
无
请求示例
请求url
https://{host}?regionId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
请求头header
无
请求体body
{
"strategyOid":"dsy-xxxxxx",
"cloudDesktopInternetAccessEnable":true,
"desktopNetworkInterworkingEnable":false,
"clientInternetConnectivity":"ALLOW",
"clientCloudLineConnectivity":"INHERIT",
"bandwidthControl":{
"enable":true,
"usbBandwidthKB":2000,
"cameraBandwidthKB":3000,
"fileDragBandwidthKB":2000,
"fileRedirectionBandwidthKB":2000,
"printerBandwidthKB":1500,
"networkRedirectionBandwidthKB":3000
}
}
响应示例
{
"statusCode":800,
"message":"OK.",
"returnObj":true
}
状态码
请参考 状态码
错误码
请参考 错误码
