文档首页/云桌面 Workspace/API参考/云应用API/策略管理/修改策略组 - UpdatePolicyGroup

更新时间：2025-12-29 GMT+08:00

修改策略组 - UpdatePolicyGroup

功能介绍

修改指定策略组的信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
workspace:policyGroups:update
Write
policyGroup *
-
-
-
user
-
userGroup
-
appGroup
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
workspace:policyGroups:update	Write	policyGroup *	-	-	-
user	-
userGroup	-
appGroup	-

URI

PATCH /v1/{project_id}/policy-groups/{policy_group_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。
policy_group_id	是	String	策略组id。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数
参数	是否必选	参数类型	描述
policy_group	是	PolicyGroupForUpdate object	修改的策略组详情。

表4 PolicyGroupForUpdate
参数	是否必选	参数类型	描述
policy_group_name	是	String	策略组名称，名称需要满足如下规则：由英文、数字或者下划线组成，不能有空格。字符长度范围1-55。
description	否	String	策略组描述。
priority	否	Integer	优先级。
targets	否	Array of Target objects	应用对象列表。
policies	否	Policies object	策略。

表5 Target
参数	是否必选	参数类型	描述
target_id	是	String	对象ID。
target_name	是	String	对象名称。
target_type	是	String	对象类型。 USER：表示用户。 USERGROUP：表示用户组。 APPGROUP：应用组。 OU：组织单元。 ALL：表示所有。 target_id：为用户ID。 target_name：为用户name。 target_id：为用户组ID。 target_name：为用户组name。 target_id：应用组id。 target_name：应用组名称。 target_id：OUID。 target_name：OU名称。 target_id：default-apply-all-targets。 target_name：All-Targets。

表6 Policies
参数	是否必选	参数类型	描述
peripherals	否	peripherals object	外设。
audio	否	audio object	音频。
client	否	client object	客户端。
display	否	display object	显示。
file_and_clipboard	否	file_and_clipboard object	文件和剪切板。
session	否	Session object	会话。
virtual_channel	否	VirtualChannel object	虚拟通道。
keyboard_mouse	否	keyboard_mouse object	键盘鼠标。
bandwidth	否	Bandwidth object	带宽。
custom	否	custom object	自定义策略。
cloud_storage	否	cloud_storage object	云存储配置。
user_profile	否	user_profile object	配置文件漫游技术配置。
url_redirection	否	url_redirection object	配置url重定向。
folder_redirection	否	folder_redirection object	配置文件夹重定向。

表7 peripherals
参数	是否必选	参数类型	描述
usb_port_redirection	否	usb_port_redirection object	USB端口重定向。
device_redirection	否	device_redirection object	设备重定向。
usb_device_common	否	usb_device_common object	USB和设备智能卡控制选项。
serial_port_redirection	否	serial_port_redirection object	串口重定向。

表8 usb_port_redirection
参数	是否必选	参数类型	描述
usb_enable	否	Boolean	是否开启USB端口重定向。取值为： false：表示关闭。 true：表示开启。
options	否	UsbPortRedirectionOptions object	USB端口重定向控制的选项。

表9 UsbPortRedirectionOptions
参数	是否必选	参数类型	描述
usb_image_enable	否	Boolean	是否开启图像设备（如: 扫描仪）。取值为： false：表示关闭。 true：表示开启。
usb_video_enable	否	Boolean	是否开启视频设备（如: 摄像头）。取值为： false：表示关闭。 true：表示开启。
usb_printer_enable	否	Boolean	是否开启打印设备（如: 打印机）。取值为： false：表示关闭。 true：表示开启。
usb_storage_enable	否	Boolean	是否开启存储设备（如: U盘）。取值为： false：表示关闭。 true：表示开启。
wireless_devices_enable	否	Boolean	是否开启无线设备（如：蓝牙）。取值为： false：表示关闭。 true：表示开启。
network_devices_enable	否	Boolean	是否开启网络设备（如：无线网卡）。取值为： false：表示关闭。 true：表示开启。
usb_smart_card_enable	否	Boolean	是否开启智能卡设备（如：Ukey）。取值为： false：表示关闭。 true：表示开启。
other_usb_devices_enable	否	Boolean	是否开启其他USB设备重定向。取值为： false：表示关闭。 true：表示开启。
usb_redirection_customization_policy	否	String	USB端口重定向自定义策略。
usb_redirection_mode	否	String	USB 重定向模式。取值为： Classical mode：经典模式。 Common mode：通用模式。

**表10** device_redirection
参数	是否必选	参数类型	描述
printer_redirection	否	printer_redirection object	打印机重定向。
session_printer	否	session_printer object	会话打印机。
camera_redirection	否	camera_redirection object	摄像头重定向。
twain_redirection_enable	否	Boolean	是否开启TWAIN设备重定向。取值为： false：表示关闭。 true：表示开启。
image_compression_level	否	String	图形压缩级别。取值为：不压缩：none。低（速度最快）：low。中（速度适中）：medium。高（速度最慢）：high。无损（无损压缩）：lossless。低损（低损压缩）：low-loss。中损（中损压缩）：medium-loss。高损（高损压缩）：high-loss。

**表11** printer_redirection
参数	是否必选	参数类型	描述
printer_enable	否	Boolean	是否开启打印机设备重定向。取值为： false：表示关闭。 true：表示开启。
options	否	PrinterRedirectionOptions object	打印机设备重定向控制的选项。

**表12** PrinterRedirectionOptions
参数	是否必选	参数类型	描述
sync_client_default_printer_enable	否	Boolean	是否开启同步客户端默认打印机。取值为： false：表示关闭。 true：表示开启。
universal_printer_driver	否	String	通用打印机驱动。取值为：- Default：linux客户端选择Universal Printing- PS，windows客户端选择HDP XPSDrv Driver。- HDP XPSDrv Driver。- Universal Printing PCL 5。- Universal Printing PCL 6。- Universal Printing PS。

**表13** session_printer
参数	是否必选	参数类型	描述
session_printer_enable	否	Boolean	是否开启会话打印机。取值为： false：表示关闭。 true：表示开启。
options	否	SessionPrinterOptions object	会话打印机控制选项。

**表14** SessionPrinterOptions
参数	是否必选	参数类型	描述
session_printer_customization_policy	否	String	会话打印机自定义策略。

**表15** camera_redirection
参数	是否必选	参数类型	描述
video_compress_enable	否	Boolean	是否开启摄像头设备重定向。取值为： false：表示关闭。 true：表示开启。
options	否	CameraRedirectionOptions object	摄像头设备重定向控制的选项。

**表16** CameraRedirectionOptions
参数	是否必选	参数类型	描述
camera_frame_rate	否	Integer	摄像头帧率（fps）。取值范围为[1-30]。默认：15。
camera_max_width	否	Integer	摄像头最大宽度（pixel）。取值范围为[1-9999]。默认：3000。
camera_max_heigth	否	Integer	摄像头最大高度（pixel）。取值范围为[1-9999]。默认：3000。
camera_compression_method	否	String	摄像头数据压缩方式。取值为：H.264。

**表17** usb_device_common
参数	是否必选	参数类型	描述
pcsc_smart_card_enable	否	String	是否开启PC/SC智能卡重定向。取值为： Enable：表示已启动。 Closed：表示已关闭。 Disable：表示已禁用。
common_options	否	common_options object	USB和设备智能卡共同控制的选项。

**表18** common_options
参数	是否必选	参数类型	描述
remove_smart_card_disconnect_enable	否	Boolean	是否移除智能卡断开用户会话。取值为： false：表示关闭。 true：表示开启。

**表19** serial_port_redirection
参数	是否必选	参数类型	描述
serial_port_enable	否	Boolean	是否开启串口重定向。取值为： false：表示关闭。 true：表示开启。
options	否	SerialPortRedirectionOptions object	串口重定向控制的选项。

**表20** SerialPortRedirectionOptions
参数	是否必选	参数类型	描述
auto_connect_enable	否	Boolean	是否自动连接客户端串口。取值为： false：表示关闭。 true：表示开启。

**表21** audio
参数	是否必选	参数类型	描述
audio_redirection_enable	否	Boolean	是否开启音频重定向。取值为： false：表示关闭。 true：表示开启。
play_redirection_enable	否	Boolean	是否开启播音重定向。取值为： false：表示关闭。 true：表示开启。
play_classification	否	String	播音场景。取值为：无损播音：LossLess。语音通话：Speech Call。音乐播音：Music Play。自动识别：Automatic Identification。
record_redirection_enable	否	Boolean	是否开启录音重定向。取值为： false：表示关闭。 true：表示开启。
record_classification	否	String	录音场景。取值为：无损录音：LossLess。语音通话：Speech Call。音乐录音：Music Record。自动识别：Automatic Identification。

**表22** client
参数	是否必选	参数类型	描述
automatic_reconnection_interval	否	Integer	自动重连间隔（秒）。取值范围为[1-50]。默认：5。
session_persistence_time	否	Integer	自动重连会话保持时长（秒）。取值范围为[0-180]。默认：180。
forbid_screen_capture	否	Boolean	防截屏策略开关。 false：表示关闭。 true：表示开启。

**表23** display
参数	是否必选	参数类型	描述
display_level	否	String	显示级别。取值为： LEVEL1：表示等级1。 LEVEL2：表示等级2。 LEVEL3：表示等级3。 LEVEL4：表示等级4（默认/推荐）。 LEVEL5：表示等级5。
options	否	DisplayOptions object	显示级别共同控制的选项。
rendering_acceleration_enable	否	Boolean	是否开启渲染加速。取值为： false：表示关闭。 true：表示开启。
rendering_acceleration_options	否	rendering_acceleration_options object	渲染加速控制选项。
video_card_memory_size	否	Integer	显卡缓存（MB）。取值范围为[0-64]。默认：64。
driver_delegation_mode_enable	否	Boolean	是否开启驱动托管模式。取值为： false：表示关闭。 true：表示开启。
driver_delegation_latency	否	Integer	驱动托管延时（*30ms）。取值范围为[1-100]。默认：80。
video_latency	否	Integer	驱动托管视频延时（*30ms）。取值范围为[1-100]。默认：80。
change_resolution_vm	否	Boolean	计算机修改分辨率：取值为： false：表示关闭。 true：表示开启。

**表24** DisplayOptions
参数	是否必选	参数类型	描述
display_bandwidth	否	Integer	带宽（Kbps）。取值范围为[256-25000]。默认：20000。
frame_rate	否	Integer	帧率（fps）。取值范围为[1-60]。默认：25。
video_frame_rate	否	Integer	视频帧率（fps）。取值范围为[1-60]。默认：30。
min_image_cache	否	Integer	图像缓存最低容量（MB）。取值范围[0-300]，默认：200。
smoothing_factor	否	Integer	有损压缩识别阈值。取值范围为[0-255]。默认：60。
lossless_compression_mode	否	String	无损压缩模式。取值为： Basic Compression：表示初级压缩。 Deep Compression：表示深度压缩。
deep_compression_options	否	deep_compression_options object	深度压缩控制选项。
lossy_compression_quality	否	Integer	有损压缩质量。取值范围为[20-100]。默认：85。
color_enhancement_enable	否	Boolean	办公场景色彩增强：取值为： false：表示关闭。 true：表示开启。
quality_bandwidth_first	否	String	质量或带宽优先。取值为： Quality First：表示初级压缩。 Bandwidth First：表示深度压缩。
video_bit_rate_options	否	video_bit_rate_options object	视频码率控制选项。
peak_video_bit_rate	否	Integer	视频峰值码率（Kbps）。取值范围为[256-100000]。默认：18000。
video_quality_options	否	video_quality_options object	视频质量控制选项。
gop_size	否	Integer	GOP大小。取值范围为[0-65535]。默认：100。
encoding_preset	否	String	编码预置。取值为：预置1：Preset 1。预置2：Preset 2。预置3：Preset 3。预置4：Preset 4。预置5：Preset 5。预置6：Preset 6。预置7：Preset 7。

**表25** deep_compression_options
参数	是否必选	参数类型	描述
deep_compression_level	否	String	深度压缩级别。取值为：压缩级别0：Compression grade 0 压缩级别1：Compression grade 1 压缩级别2：Compression grade 2 压缩级别3：Compression grade 3 压缩级别4：Compression grade 4 压缩级别5：Compression grade 5 压缩级别6：Compression grade 6 压缩级别7：Compression grade 7 压缩级别8：Compression grade 8 压缩级别9：Compression grade 9

**表26** video_bit_rate_options
参数	是否必选	参数类型	描述
average_video_bit_rate	否	Integer	视频平均码率（Kbps）。取值范围为[256-100000]。默认：18000。

**表27** video_quality_options
参数	是否必选	参数类型	描述
average_video_quality	否	Integer	视频平均质量。取值范围为[5-59]。默认：15。
lowest_video_quality	否	Integer	视频最低质量。取值范围为[5-69]。默认：25。
highest_video_quality	否	Integer	视频最高质量。取值范围为[1-59]。默认：7。

**表28** rendering_acceleration_options
参数	是否必选	参数类型	描述
video_acceleration_enhancement_enable	否	Boolean	视频加速增强配置。取值为： false：表示关闭。 true：表示开启。
video_optimization_enable	否	Boolean	是否开启视频场景优化。取值为： false：表示关闭。 true：表示开启。
gpu_color_optimization_enable	否	Boolean	是否开启GPU色彩优化。取值为： false：表示关闭。 true：表示开启。

**表29** file_and_clipboard
参数	是否必选	参数类型	描述
bypass_in_remote_app_enable	否	Boolean	应用聚合场景下是否双向放通：取值为： false：表示不放通。 true：表示放通。
file_redirection	否	file_redirection object	文件重定向。
fd_mobile_client_redir_enable	否	Boolean	移动客户端文件重定向：取值为： false：表示关闭。 true：表示开启。
clipboard_redirection	否	String	剪切板重定向。取值为： DISABLED：表示禁用。（默认） SERVER_TO_CLIENT_ENABLED：表示开启服务端到客户端。 CLIENT_TO_SERVER_ENABLED：表示开启客户端到服务端。 TWO_WAY_ENABLED：表示开启双向。
clipboard_redirection_options	否	clipboard_redirection_options object	剪切板重定向控制的选项。

**表30** file_redirection
参数	是否必选	参数类型	描述
redirection_mode	否	String	文件重定向。取值为： DISABLED：表示禁用。（默认） READ_ONLY：表示只读。 READ_AND_WRITE：表示读写。
options	否	FileRedirectionOptions object	文件重定向控制的选项。
vm_send_file_client	否	Boolean	是否开启发送文件（虚机到客户端）。取值为： false：表示关闭。 true：表示开启。
redirection_send_file_options	否	redirection_send_file_options object	重定向和发送文件共同控制项。

**表31** FileRedirectionOptions
参数	是否必选	参数类型	描述
fluid_control_switch_enable	否	Boolean	是否开启流控开关。取值为： false：表示关闭。 true：表示开启。
fluid_control_options	否	fluid_control_options object	流控控制项。
compression_switch_enable	否	Boolean	是否开启压缩开关。取值为： false：表示关闭。 true：表示开启。
compression_switch_options	否	compression_switch_options object	压缩开关控制项。
linux_file_size_supported_enable	否	Boolean	是否开启Linux支持设置文件大小。取值为： false：表示关闭。 true：表示开启。
linux_file_size_supported_options	否	linux_file_size_supported_options object	Linux支持设置文件大小控制项。
linux_root_mount_switch_enable	否	Boolean	是否开启Linux根目录挂载开关。取值为： false：表示关闭。 true：表示开启。
linux_root_dir_list	否	String	Linux根目录挂载路径。默认："\home"。
linux_file_mount_path	否	String	Linux文件系统挂载路径。默认："\media\|\Volumes\|\swdb\mnt\|\home\|\storage\|\tmp\|\run\media"。
linux_fixed_drive_file_system_format	否	String	Linux固定驱动器文件系统格式。
linux_removable_drive_file_system_format	否	String	Linux可移动驱动器文件系统格式。默认："vfat\|ntfs\|msdos\|fuseblk\|sdcardfs\|exfat\|fuse.fdredir"。
linux_cdrom_drive_file_system_format	否	String	Linux光盘驱动器文件系统格式。默认："cd9660\|iso9660\|udf"。
linux_network_drive_file_system_format	否	String	Linux网络驱动器文件系统格式。默认："smbfs\|afpfs\|cifs"。
path_separator	否	String	路径分隔符。默认："\|"。
fixed_drive_enable	否	Boolean	是否开启固定驱动器（如: 本地磁盘）。取值为： false：表示关闭。 true：表示开启。
removable_drive_enable	否	Boolean	是否开启可移除驱动器（如: U盘）。取值为： false：表示关闭。 true：表示开启。
cd_rom_drive_enable	否	Boolean	是否开启光盘驱动器。取值为： false：表示关闭。 true：表示开启。
network_drive_enable	否	Boolean	是否开启网络驱动器。取值为： false：表示关闭。 true：表示开启。

**表32** fluid_control_options
参数	是否必选	参数类型	描述
good_network_latency	否	Integer	网络优的延时阈值（ms）。取值范围为[1-1000]。默认：30。
normal_network_latency	否	Integer	网络一般的延时阈值（ms）。取值范围为[1-1000]。默认：70。
poor_network_latency	否	Integer	网络差的延时阈值（ms）。取值范围为[1-1000]。默认：100。
reducing_step	否	Integer	降速步伐（KB）。取值范围为[1-100]。默认：20。
slow_increasing_step	否	Integer	慢增速步伐（KB）。取值范围为[1-100]。默认：10。
quick_increasing_step	否	Integer	快增速步伐（KB）。取值范围为[1-100]。默认：20。
start_speed	否	Integer	传输初始速度（KB/s）。取值范围为[1-10240]。默认：1024。
test_block_size	否	Integer	测速块大小（KB）。取值范围为[64-1024]。默认：64。
test_time_gap	否	Integer	测速块时间间隔（ms）。取值范围为[1000-100000]。默认：10000。

**表33** compression_switch_options
参数	是否必选	参数类型	描述
compression_threshold	否	Integer	压缩阈值（Byte）。取值范围为[0-10240]。默认：512。
minimum_compression_rate	否	Integer	最小压缩率。取值范围为[0-1000]。默认：900。

**表34** linux_file_size_supported_options
参数	是否必选	参数类型	描述
linux_file_size_supported_threshold	否	Integer	Linux设置文件大小阈值（Byte）。取值范围为[0-4096]。默认：100。

**表35** redirection_send_file_options
参数	是否必选	参数类型	描述
read_write_speed	否	Integer	读写速度（Kbps）。取值范围为[0-2147483647]。默认：0。

**表36** clipboard_redirection_options
参数	是否必选	参数类型	描述
rich_text_redirection_enable	否	Boolean	是否开启剪切板富文本重定向。取值为： false：表示关闭。 true：表示开启。
rich_text_clipboard_redirection	否	String	剪切板富文本重定向。取值为： DISABLED：表示禁用。（默认） SERVER_TO_CLIENT_ENABLED：表示开启服务端到客户端。 CLIENT_TO_SERVER_ENABLED：表示开启客户端到服务端。 TWO_WAY_ENABLED：表示开启双向。
clipboard_file_redirection_enable	否	Boolean	是否开启剪切板文件重定向。取值为： false：表示关闭。 true：表示开启。
file_clipboard_redirection	否	String	剪切板文件重定向。取值为： DISABLED：表示禁用。（默认） SERVER_TO_CLIENT_ENABLED：表示开启服务端到客户端。 CLIENT_TO_SERVER_ENABLED：表示开启客户端到服务端。 TWO_WAY_ENABLED：表示开启双向。
clipboard_length_limit_cts_enable	否	Boolean	本地到虚拟机长度限制开关。取值为： false: 标识关闭。 ture: 标识开启。
clipboard_length_limit_cts	否	Integer	本地到虚拟机长度限制。
clipboard_length_limit_stc_enable	否	Boolean	虚拟机到本地到长度限制开关。取值为： false: 标识关闭。 ture: 标识开启。
clipboard_length_limit_stc	否	Integer	虚拟机到本地长度限制。

**表37** Session
参数	是否必选	参数类型	描述
sbc	否	Sbc object	SBC结构体。

**表38** Sbc
参数	是否必选	参数类型	描述
sbc_automatic_disconnection	否	String	连接策略： DISABLED：已禁用 AUTO_DISCONNECT：自动断开 AUTO_LOCK：自动锁屏
sbc_automatic_disconnection_options	否	SbcAutomaticDisconnectionOptions object	自动连接选项。

**表39** SbcAutomaticDisconnectionOptions
参数	是否必选	参数类型	描述
disconnection_waiting_time	否	Integer	等待时间（分钟）。
sbc_auto_logout	否	Boolean	是否自动注销。取值为：false：表示是。true：表示否。
auto_logout_options	否	AutoLogoutOptions object	自动注销。

**表40** AutoLogoutOptions
参数	是否必选	参数类型	描述
sbc_logout_waiting_time	否	Integer	会话断连保留时长（分钟）。

**表41** VirtualChannel
参数	是否必选	参数类型	描述
virtual_channel_control_enable	否	Boolean	是否开启虚拟通道策略设置。取值为：false：表示关闭。true：表示开启。
options	否	VirtualChannelOptions object	虚拟通道策略控制的选项。

**表42** VirtualChannelOptions
参数	是否必选	参数类型	描述
custom_virtual_channel_name	否	String	自定义虚拟通道注册名。
virtual_channel_plugin_details	否	String	虚拟通道下载配置信息，需Base64加密。
third_party_plugin_name	否	String	第三方插件名称。

**表43** keyboard_mouse
参数	是否必选	参数类型	描述
mouse_feedback	否	String	虚拟机鼠标回馈。取值为： SELFADAPTION：自适应鼠标回馈。 FORCE：强制鼠标回馈。 CLOSE：关闭鼠标回馈。
mouse_simulation_mode	否	String	虚拟机鼠标模拟方式。取值为： ABSOLUTE_POSITION：绝对位置模拟。 RELATIVE_POSITION：相对位置模拟。
external_cursor_feedback	否	Boolean	虚拟机外部光标反馈。取值为： false：表示关闭。 true：表示开启。

**表44** Bandwidth
参数	是否必选	参数类型	描述
intelligent_data_transport_flag	否	String	智能显示传输。取值为：DISABLE：表示关闭。ENABLE：表示开启。DIAGNOSTIC：诊断模式。
total_bandwidth_control_enable	否	Boolean	是否开启总带宽控制。取值为：false：表示关闭。true：表示开启。
options	否	TotalBandwidthControlOptions object	总带宽控制的选项。
display_bandwidth_control_enable	否	Boolean	是否开启显示带宽控制。取值为：false：表示关闭。true：表示开启。
display_bandwidth_control_options	否	DisplayBandwidthControlOptions object	显示带宽控制的选项。
multimedia_bandwidth_control_enable	否	Boolean	是否开启多媒体带宽控制。取值为：false：表示关闭。true：表示开启。
multimedia_bandwidth_control_options	否	MultimediaBandwidthControlOptions object	多媒体带宽控制的选项。
usb_bandwidth_control_enable	否	Boolean	是否开启USB带宽控制。取值为：false：表示关闭。true：表示开启。
usb_bandwidth_control_options	否	UsbBandwidthControlOptions object	USB带宽控制的选项。
pcsc_bandwidth_control_enable	否	Boolean	是否开启PCSC控制。取值为：false：表示关闭。true：表示开启。
pcsc_bandwidth_control_options	否	PcscBandwidthControlOptions object	PCSC带宽控制的选项。
twain_bandwidth_control_enable	否	Boolean	是否开启TWAIN带宽控制。取值为：false：表示关闭。true：表示开启。
twain_bandwidth_control_options	否	TwainBandwidthControlOptions object	TWAIN带宽控制的选项。
printer_bandwidth_control_enable	否	Boolean	是否开启打印机带宽控制。取值为：false：表示关闭。true：表示开启。
printer_bandwidth_control_options	否	PrinterBandwidthControlOptions object	打印机带宽控制的选项。
com_bandwidth_control_enable	否	Boolean	是否开启串口带宽控制。取值为：false：表示关闭。true：表示开启。
com_bandwidth_control_options	否	ComBandwidthControlOptions object	串口带宽控制的选项。
file_redirection_bandwidth_control_enable	否	Boolean	是否开启文件重定向带宽控制。取值为：false：表示关闭。true：表示开启。
file_redirection_bandwidth_control_options	否	FileRedirectionBandwidthControlOptions object	文件重定向带宽控制的选项。
clipboard_bandwidth_control_enable	否	Boolean	是否开启剪切板带宽控制。取值为：false：表示关闭。true：表示开启。
clipboard_bandwidth_control_options	否	ClipboardBandwidthControlOptions object	剪切板带宽控制的选项。
secure_channel_bandwidth_control_enable	否	Boolean	是否开启安全通道带宽控制。取值为：false：表示关闭。true：表示开启。
secure_channel_bandwidth_control_options	否	SecureChannelBandwidthControlOptions object	安全通道带宽控制的选项。
camera_bandwidth_control_enable	否	Boolean	是否开启摄像头带宽控制。取值为：false：表示关闭。true：表示开启。
camera_bandwidth_control_options	否	CameraBandwidthControlOptions object	摄像头带宽控制的选项。
virtual_channel_bandwidth_control_enable	否	Boolean	是否开启虚拟通道带宽控制。取值为：false：表示关闭。true：表示开启。
virtual_channel_bandwidth_control_options	否	VirtualChannelBandwidthControlOptions object	虚拟通道带宽控制的选项。

**表45** TotalBandwidthControlOptions
参数	是否必选	参数类型	描述
total_bandwidth_control_value	否	Integer	总带宽控制量（Kbps）。取值范围为[10000-1000000]。默认：30000。
display_bandwidth_percentage_enable	否	Boolean	显示带宽百分比控制。取值为：false：表示关闭。true：表示开启。
display_bandwidth_percentage_options	否	DisplayBandwidthPercentageOptions object	显示带宽百分比控制的选项。
multimedia_bandwidth_percentage_enable	否	Boolean	多媒体带宽百分比控制。取值为：false：表示关闭。true：表示开启。
multimedia_bandwidth_percentage_options	否	MultimediaBandwidthPercentageOptions object	多媒体带宽百分比控制的选项。
usb_bandwidth_percentage_enable	否	Boolean	USB带宽百分比控制。取值为：false：表示关闭。true：表示开启。
usb_bandwidth_percentage_options	否	UsbBandwidthPercentageOptions object	USB带宽百分比控制的选项。
pcsc_bandwidth_percentage_enable	否	Boolean	PCSC带宽百分比控制。取值为：false：表示关闭。true：表示开启。
pcsc_bandwidth_percentage_options	否	PcscBandwidthPercentageOptions object	PCSC带宽百分比控制的选项。
twain_bandwidth_percentage_enable	否	Boolean	TWAIN带宽百分比控制。取值为：false：表示关闭。true：表示开启。
twain_bandwidth_percentage_options	否	TwainBandwidthPercentageOptions object	TWAIN带宽百分比控制的选项。
printer_bandwidth_percentage_enable	否	Boolean	打印机带宽百分比控制。取值为：false：表示关闭。true：表示开启。
printer_bandwidth_percentage_options	否	PrinterBandwidthPercentageOptions object	打印机带宽百分比控制的选项。
com_bandwidth_percentage_enable	否	Boolean	串口带宽百分比控制。取值为：false：表示关闭。true：表示开启。
com_bandwidth_percentage_options	否	ComBandwidthPercentageOptions object	串口带宽百分比控制的选项。
file_redirection_bandwidth_percentage_enable	否	Boolean	文件重定向带宽百分比控制。取值为：false：表示关闭。true：表示开启。
file_redirection_bandwidth_percentage_options	否	FileRedirectionBandwidthPercentageOptions object	文件重定向带宽百分比控制的选项。
clipboard_bandwidth_percentage_enable	否	Boolean	剪切板带宽百分比控制。取值为：false：表示关闭。true：表示开启。
clipboard_bandwidth_percentage_options	否	ClipboardBandwidthPercentageOptions object	剪切板带宽百分比控制的选项。
secure_channel_bandwidth_percentage_enable	否	Boolean	安全通道带宽百分比控制。取值为：false：表示关闭。true：表示开启。
secure_channel_bandwidth_percentage_options	否	SecureChannelBandwidthPercentageOptions object	安全通道带宽百分比控制的选项。
camera_bandwidth_percentage_enable	否	Boolean	摄像头带宽百分比控制。取值为：false：表示关闭。true：表示开启。
camera_bandwidth_percentage_options	否	CameraBandwidthPercentageOptions object	摄像头带宽百分比控制的选项。
virtual_channel_bandwidth_percentage_enable	否	Boolean	虚拟通道带宽百分比控制。取值为：false：表示关闭。true：表示开启。
virtual_channel_bandwidth_percentage_options	否	VirtualChannelBandwidthPercentageOptions object	虚拟通道带宽百分比控制的选项。

**表46** DisplayBandwidthPercentageOptions
参数	是否必选	参数类型	描述
display_bandwidth_percentage_value	否	Integer	显示带宽百分比控制量（%）。取值范围为[0-100]。默认：65。

**表47** MultimediaBandwidthPercentageOptions
参数	是否必选	参数类型	描述
multimedia_bandwidth_percentage_value	否	Integer	多媒体带宽百分比控制量（%）。取值范围为[0-100]。默认：50。

**表48** UsbBandwidthPercentageOptions
参数	是否必选	参数类型	描述
usb_bandwidth_percentage_value	否	Integer	USB带宽百分比控制量（%）。取值范围为[0-100]。默认：100。

**表49** PcscBandwidthPercentageOptions
参数	是否必选	参数类型	描述
pcsc_bandwidth_percentage_value	否	Integer	PCSC带宽百分比控制量（%）。取值范围为[0-100]。默认：5。

**表50** TwainBandwidthPercentageOptions
参数	是否必选	参数类型	描述
twain_bandwidth_percentage_value	否	Integer	TWAIN带宽百分比控制量（%）。取值范围为[0-100]。默认：15。

**表51** PrinterBandwidthPercentageOptions
参数	是否必选	参数类型	描述
printer_bandwidth_percentage_value	否	Integer	打印机带宽百分比控制量（%）。取值范围为[0-100]。默认：5。

**表52** ComBandwidthPercentageOptions
参数	是否必选	参数类型	描述
com_bandwidth_percentage_value	否	Integer	串口带宽百分比控制量（%）。取值范围为[0-100]。默认：3。

**表53** FileRedirectionBandwidthPercentageOptions
参数	是否必选	参数类型	描述
file_redirection_bandwidth_percentage_value	否	Integer	文件重定向带宽百分比控制量（%）。取值范围为[0-100]。默认：30。

**表54** ClipboardBandwidthPercentageOptions
参数	是否必选	参数类型	描述
clipboard_bandwidth_percentage_value	否	Integer	剪切板带宽百分比控制量（%）。取值范围为[0-100]。默认：3。

**表55** SecureChannelBandwidthPercentageOptions
参数	是否必选	参数类型	描述
secure_channel_bandwidth_percentage_value	否	Integer	安全通道带宽百分比控制量（%）。取值范围为[0-100]。默认：30。

**表56** CameraBandwidthPercentageOptions
参数	是否必选	参数类型	描述
camera_bandwidth_percentage_value	否	Integer	摄像头带宽百分比控制量（%）。取值范围为[0-100]。默认：30。

**表57** VirtualChannelBandwidthPercentageOptions
参数	是否必选	参数类型	描述
virtual_channel_bandwidth_percentage_value	否	Integer	虚拟通道带宽百分比控制量（%）。取值范围为[0-100]。默认：65。

**表58** DisplayBandwidthControlOptions
参数	是否必选	参数类型	描述
display_bandwidth_control_value	否	Integer	显示带宽控制量（Kbps）。取值范围为[500-50000]。默认：20000。

**表59** MultimediaBandwidthControlOptions
参数	是否必选	参数类型	描述
multimedia_bandwidth_control_value	否	Integer	多媒体带宽控制量（Kbps）。取值范围为[5000-20000]。默认：15000。

**表60** UsbBandwidthControlOptions
参数	是否必选	参数类型	描述
usb_bandwidth_control_value	否	Integer	USB带宽控制量（Kbps）。取值范围为[1000-30000]。默认：30000。

**表61** PcscBandwidthControlOptions
参数	是否必选	参数类型	描述
pcsc_bandwidth_control_value	否	Integer	PCSC带宽控制量（Kbps）。取值范围为[1000-5000]。默认：2000。

**表62** TwainBandwidthControlOptions
参数	是否必选	参数类型	描述
twain_bandwidth_control_value	否	Integer	TWAIN带宽控制量（Kbps）。取值范围为[2000-10000]。默认：5000。

**表63** PrinterBandwidthControlOptions
参数	是否必选	参数类型	描述
printer_bandwidth_control_value	否	Integer	打印机带宽控制量（Kbps）。取值范围为[1000-5000]。默认：2000。

**表64** ComBandwidthControlOptions
参数	是否必选	参数类型	描述
com_bandwidth_control_value	否	Integer	串口带宽控制量（Kbps）。取值范围为[500-2000]。默认：1000。

**表65** FileRedirectionBandwidthControlOptions
参数	是否必选	参数类型	描述
file_redirection_bandwidth_control_value	否	Integer	文件重定向带宽控制量（Kbps）。取值范围为[500-20000]。默认：10000。

**表66** ClipboardBandwidthControlOptions
参数	是否必选	参数类型	描述
clipboard_bandwidth_control_value	否	Integer	剪切板带宽控制量（Kbps）。取值范围为[100-2000]。默认：1000。

**表67** SecureChannelBandwidthControlOptions
参数	是否必选	参数类型	描述
secure_channel_bandwidth_control_value	否	Integer	安全通道带宽控制量（Kbps）。取值范围为[500-20000]。默认：10000。

**表68** CameraBandwidthControlOptions
参数	是否必选	参数类型	描述
camera_bandwidth_control_value	否	Integer	摄像头带宽控制量（Kbps）。取值范围为[0-10000]。默认：10000。

**表69** VirtualChannelBandwidthControlOptions
参数	是否必选	参数类型	描述
virtual_channel_bandwidth_control_value	否	Integer	虚拟通道带宽控制量（Kbps）。取值范围为[500-20000]。默认：20000。

**表70** custom
参数	是否必选	参数类型	描述
custom_configuration1_enable	否	Boolean	自定义策略配置项1： false: 表示关闭 true: 表示开启
options	否	CustomOptions object	自定义策略设置项。

**表71** CustomOptions
参数	是否必选	参数类型	描述
custom_configuration1_rule	否	String	配置项1内容。
rail_transparent_config	否	RailTransparentConfig object	应用镜像策略设置项。

**表72** RailTransparentConfig
参数	是否必选	参数类型	描述
select_policy	否	Integer	策略选值原则。
transparent_list_custom	否	String	配置项内容。

**表73** cloud_storage
参数	是否必选	参数类型	描述
cloud_storage_enable	否	Boolean	云存储配置开关： false: 表示关闭 true: 表示开启
options	否	CloudStorageOptions object	云存储配置。

**表74** CloudStorageOptions
参数	是否必选	参数类型	描述
cloud_storage_rule	否	String	配置项内容。

**表75** user_profile
参数	是否必选	参数类型	描述
user_profile_enable	否	Boolean	配置文件漫游技术配置开关： false: 表示关闭 true: 表示开启
options	否	UpmOptions object	配置文件漫游技术配置。

**表76** UpmOptions
参数	是否必选	参数类型	描述
user_profile_rule	否	String	配置项内容。
redir_exclude_common_folders	否	String	排除常用文件夹。
redir_exclude_copy0s	否	String	禁止自定义文件夹/copy base =0,copy back =0。
redir_exclude_copy1s	否	String	禁止自定义文件夹/copy base =0,copy back =1。
redir_exclude_copy2s	否	String	禁止自定义文件夹/copy base =1,copy back =0。
redir_exclude_copy3s	否	String	禁止自定义文件夹/copy base =1,copy back =1。
redir_exclude_includes	否	String	允许自定义文件夹

**表77** url_redirection
参数	是否必选	参数类型	描述
url_redirection_enable	否	Boolean	配置url重定向开关： false: 表示关闭 true: 表示开启
options	否	UrlRedirectionOptions object	url重定向配置。

**表78** UrlRedirectionOptions
参数	是否必选	参数类型	描述
url_include_list	否	String	允许重定向url。
url_exclude_list	否	String	拒绝重定向url。

**表79** folder_redirection
参数	是否必选	参数类型	描述
folder_redirection_status	否	Integer	配置文件夹重定向状态： 0: 已禁用 1: 已启用 2: 未配置
options	否	FolderRedirectionOptions object	文件夹重定向配置。

**表80** FolderRedirectionOptions
参数	是否必选	参数类型	描述
relative_path	否	String	目标文件夹位置。
storage_paths	否	String	用户存储路径。
include_common_folders	否	Integer	文件夹选项。

响应参数

状态码：200

**表81** 响应Body参数
参数	参数类型	描述
id	String	被修改策略主键。

状态码：400

**表82** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：401

**表83** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：403

**表84** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：404

**表85** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：405

**表86** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：500

**表87** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：503

**表88** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

请求示例

PATCH /v1/29dfe82ada564ac2b927e1ff036d9a9b/policy-groups/1d23e82ada564ac2b927e1ff0361fe23

{
  "policy_group" : { }
}

响应示例

状态码：200

成功响应。

{
  "id" : "2c9080c97f310b73017f3f9501070043"
}

状态码

状态码	描述
200	成功响应。
400	由于包含语法错误，当前请求无法被服务器理解。
401	鉴权失败。
403	没有操作权限。
404	找不到资源。
405	请求中指定的方法不被允许。
500	服务内部错误，具体返回错误码请参见错误码说明。
503	服务不可用。