# 新增策略组 - CreatePolicyGroup #### 功能介绍 新增策略组，通过策略组能灵活地控制客户端访问与接入策略，如：文件、剪切板、会话等。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/WorkspaceApp/doc?api=CreatePolicyGroup)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-workspace/workspace_09_0128.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | workspace:policyGroups:create | Write | policyGroup \* | - | - | - workspace:desktopPools:list - workspace:quotas:get - workspace:tenants:getLockStatus | | workspace:policyGroups:create | Write | desktop | - | - | - workspace:desktopPools:list - workspace:quotas:get - workspace:tenants:getLockStatus | | workspace:policyGroups:create | Write | desktopPool | - | - | - workspace:desktopPools:list - workspace:quotas:get - workspace:tenants:getLockStatus | | workspace:policyGroups:create | Write | user | - | - | - workspace:desktopPools:list - workspace:quotas:get - workspace:tenants:getLockStatus | | workspace:policyGroups:create | Write | userGroup | - | - | - workspace:desktopPools:list - workspace:quotas:get - workspace:tenants:getLockStatus | | workspace:policyGroups:create | Write | appGroup | - | - | - workspace:desktopPools:list - workspace:quotas:get - workspace:tenants:getLockStatus | #### URI POST /v1/{project_id}/policy-groups 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 否 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | policy_group | 是 | [PolicyGroupForCreate] object | 策略组信息。 | 表4PolicyGroupForCreate | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | policy_group_name | 是 | String | 策略组名称，名称需要满足如下规则： 1. 由英文、数字或者下划线组成，不能有空格。 2. 字符长度范围1-55。 | | priority | 否 | Integer | 优先级。 | | description | 否 | String | 策略组描述。 | | targets | 否 | Array of [Target] objects | 应用对象列表。 | | policies | 否 | [Policies] object | 策略。 | 表5Target | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 | 表6Policies | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 配置文件夹重定向。 | | folder_redirection_v2 | 否 | [folder_redirection_v2] object | 配置文件夹重定向(v2)。 | | user_profile_management | 否 | [user_profile_management] object | 用户配置策略。 | 表7peripherals | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 串口重定向。 | 表8usb_port_redirection | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | usb_enable | 否 | Boolean | 是否开启USB端口重定向。取值为： - false：表示关闭。 - true：表示开启。 | | options | 否 | [UsbPortRedirectionOptions] object | USB端口重定向控制的选项。 | 表9UsbPortRedirectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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：通用模式。 | 表10device_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。 | 表11printer_redirection | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | printer_enable | 否 | Boolean | 是否开启打印机设备重定向。取值为： - false：表示关闭。 - true：表示开启。 | | options | 否 | [PrinterRedirectionOptions] object | 打印机设备重定向控制的选项。 | 表12PrinterRedirectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 | 表13session_printer | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | session_printer_enable | 否 | Boolean | 是否开启会话打印机。取值为： false：表示关闭。 true：表示开启。 | | options | 否 | [SessionPrinterOptions] object | 会话打印机控制选项。 | 表14SessionPrinterOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | session_printer_customization_policy | 否 | String | 会话打印机自定义策略。 | 表15camera_redirection | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | video_compress_enable | 否 | Boolean | 是否开启摄像头设备重定向。取值为： false：表示关闭。 true：表示开启。 | | options | 否 | [CameraRedirectionOptions] object | 摄像头设备重定向控制的选项。 | 表16CameraRedirectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 | 表17usb_device_common | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | pcsc_smart_card_enable | 否 | String | 是否开启PC/SC智能卡重定向。取值为： Enable：表示已启动。 Closed：表示已关闭。 Disable：表示已禁用。 | | common_options | 否 | [common_options] object | USB和设备智能卡共同控制的选项。 | 表18common_options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | remove_smart_card_disconnect_enable | 否 | Boolean | 是否移除智能卡断开用户会话。取值为： false：表示关闭。 true：表示开启。 | 表19serial_port_redirection | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | serial_port_enable | 否 | Boolean | 是否开启串口重定向。取值为： false：表示关闭。 true：表示开启。 | | options | 否 | [SerialPortRedirectionOptions] object | 串口重定向控制的选项。 | 表20SerialPortRedirectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | auto_connect_enable | 否 | Boolean | 是否自动连接客户端串口。取值为： false：表示关闭。 true：表示开启。 | 表21audio | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 | 表22client | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | automatic_reconnection_interval | 否 | Integer | 自动重连间隔（秒）。取值范围为\[1-50\]。默认：5。 | | session_persistence_time | 否 | Integer | 自动重连会话保持时长（秒）。取值范围为\[0-180\]。默认：180。 | | forbid_screen_capture | 否 | Boolean | 防截屏策略开关。 false：表示关闭。 true：表示开启。 | 表23display | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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：表示开启。 | 表24DisplayOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 | 表25deep_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 | 表26video_bit_rate_options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | average_video_bit_rate | 否 | Integer | 视频平均码率（Kbps）。取值范围为\[256-100000\]。默认：18000。 | 表27video_quality_options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | average_video_quality | 否 | Integer | 视频平均质量。取值范围为\[5-59\]。默认：15。 | | lowest_video_quality | 否 | Integer | 视频最低质量。取值范围为\[5-69\]。默认：25。 | | highest_video_quality | 否 | Integer | 视频最高质量。取值范围为\[1-59\]。默认：7。 | 表28rendering_acceleration_options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | video_acceleration_enhancement_enable | 否 | Boolean | 视频加速增强配置。取值为： false：表示关闭。 true：表示开启。 | | video_optimization_enable | 否 | Boolean | 是否开启视频场景优化。取值为： false：表示关闭。 true：表示开启。 | | gpu_color_optimization_enable | 否 | Boolean | 是否开启GPU色彩优化。取值为： false：表示关闭。 true：表示开启。 | 表29file_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 | 剪切板重定向控制的选项。 | 表30file_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 | 重定向和发送文件共同控制项。 | 表31FileRedirectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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：表示开启。 | 表32fluid_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。 | 表33compression_switch_options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | compression_threshold | 否 | Integer | 压缩阈值（Byte）。取值范围为\[0-10240\]。默认：512。 | | minimum_compression_rate | 否 | Integer | 最小压缩率。取值范围为\[0-1000\]。默认：900。 | 表34linux_file_size_supported_options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | linux_file_size_supported_threshold | 否 | Integer | Linux设置文件大小阈值（Byte）。取值范围为\[0-4096\]。默认：100。 | 表35redirection_send_file_options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | read_write_speed | 否 | Integer | 读写速度（Kbps）。取值范围为\[0-2147483647\]。默认：0。 | 表36clipboard_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 | 虚拟机到本地长度限制。 | 表37Session | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | sbc | 否 | [Sbc] object | SBC结构体。 | 表38Sbc | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | sbc_automatic_disconnection | 否 | String | 连接策略： - DISABLED：已禁用 - AUTO_DISCONNECT：自动断开 - AUTO_LOCK：自动锁屏 | | sbc_automatic_disconnection_options | 否 | [SbcAutomaticDisconnectionOptions] object | 自动连接选项。 | 表39SbcAutomaticDisconnectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | disconnection_waiting_time | 否 | Integer | 等待时间（分钟）。 | | sbc_auto_logout | 否 | Boolean | 是否自动注销。取值为：false：表示是。true：表示否。 | | auto_logout_options | 否 | [AutoLogoutOptions] object | 自动注销。 | 表40AutoLogoutOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | sbc_logout_waiting_time | 否 | Integer | 会话断连保留时长（分钟）。 | 表41VirtualChannel | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | virtual_channel_control_enable | 否 | Boolean | 是否开启虚拟通道策略设置。取值为：false：表示关闭。true：表示开启。 | | options | 否 | [VirtualChannelOptions] object | 虚拟通道策略控制的选项。 | 表42VirtualChannelOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | custom_virtual_channel_name | 否 | String | 自定义虚拟通道注册名。 | | virtual_channel_plugin_details | 否 | String | 虚拟通道下载配置信息，需Base64加密。 | | third_party_plugin_name | 否 | String | 第三方插件名称。 | 表43keyboard_mouse | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | mouse_feedback | 否 | String | 虚拟机鼠标回馈。取值为： SELFADAPTION：自适应鼠标回馈。 FORCE：强制鼠标回馈。 CLOSE：关闭鼠标回馈。 | | mouse_simulation_mode | 否 | String | 虚拟机鼠标模拟方式。取值为： ABSOLUTE_POSITION：绝对位置模拟。 RELATIVE_POSITION：相对位置模拟。 | | external_cursor_feedback | 否 | Boolean | 虚拟机外部光标反馈。取值为： false：表示关闭。 true：表示开启。 | 表44Bandwidth | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 虚拟通道带宽控制的选项。 | 表45TotalBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 虚拟通道带宽百分比控制的选项。 | 表46DisplayBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | display_bandwidth_percentage_value | 否 | Integer | 显示带宽百分比控制量（%）。取值范围为\[0-100\]。默认：65。 | 表47MultimediaBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | multimedia_bandwidth_percentage_value | 否 | Integer | 多媒体带宽百分比控制量（%）。取值范围为\[0-100\]。默认：50。 | 表48UsbBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | usb_bandwidth_percentage_value | 否 | Integer | USB带宽百分比控制量（%）。取值范围为\[0-100\]。默认：100。 | 表49PcscBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | pcsc_bandwidth_percentage_value | 否 | Integer | PCSC带宽百分比控制量（%）。取值范围为\[0-100\]。默认：5。 | 表50TwainBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | twain_bandwidth_percentage_value | 否 | Integer | TWAIN带宽百分比控制量（%）。取值范围为\[0-100\]。默认：15。 | 表51PrinterBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | printer_bandwidth_percentage_value | 否 | Integer | 打印机带宽百分比控制量（%）。取值范围为\[0-100\]。默认：5。 | 表52ComBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | com_bandwidth_percentage_value | 否 | Integer | 串口带宽百分比控制量（%）。取值范围为\[0-100\]。默认：3。 | 表53FileRedirectionBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | file_redirection_bandwidth_percentage_value | 否 | Integer | 文件重定向带宽百分比控制量（%）。取值范围为\[0-100\]。默认：30。 | 表54ClipboardBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | clipboard_bandwidth_percentage_value | 否 | Integer | 剪切板带宽百分比控制量（%）。取值范围为\[0-100\]。默认：3。 | 表55SecureChannelBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | secure_channel_bandwidth_percentage_value | 否 | Integer | 安全通道带宽百分比控制量（%）。取值范围为\[0-100\]。默认：30。 | 表56CameraBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | camera_bandwidth_percentage_value | 否 | Integer | 摄像头带宽百分比控制量（%）。取值范围为\[0-100\]。默认：30。 | 表57VirtualChannelBandwidthPercentageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | virtual_channel_bandwidth_percentage_value | 否 | Integer | 虚拟通道带宽百分比控制量（%）。取值范围为\[0-100\]。默认：65。 | 表58DisplayBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | display_bandwidth_control_value | 否 | Integer | 显示带宽控制量（Kbps）。取值范围为\[500-50000\]。默认：20000。 | 表59MultimediaBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | multimedia_bandwidth_control_value | 否 | Integer | 多媒体带宽控制量（Kbps）。取值范围为\[5000-20000\]。默认：15000。 | 表60UsbBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | usb_bandwidth_control_value | 否 | Integer | USB带宽控制量（Kbps）。取值范围为\[1000-30000\]。默认：30000。 | 表61PcscBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | pcsc_bandwidth_control_value | 否 | Integer | PCSC带宽控制量（Kbps）。取值范围为\[1000-5000\]。默认：2000。 | 表62TwainBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | twain_bandwidth_control_value | 否 | Integer | TWAIN带宽控制量（Kbps）。取值范围为\[2000-10000\]。默认：5000。 | 表63PrinterBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | printer_bandwidth_control_value | 否 | Integer | 打印机带宽控制量（Kbps）。取值范围为\[1000-5000\]。默认：2000。 | 表64ComBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | com_bandwidth_control_value | 否 | Integer | 串口带宽控制量（Kbps）。取值范围为\[500-2000\]。默认：1000。 | 表65FileRedirectionBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | file_redirection_bandwidth_control_value | 否 | Integer | 文件重定向带宽控制量（Kbps）。取值范围为\[500-20000\]。默认：10000。 | 表66ClipboardBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | clipboard_bandwidth_control_value | 否 | Integer | 剪切板带宽控制量（Kbps）。取值范围为\[100-2000\]。默认：1000。 | 表67SecureChannelBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | secure_channel_bandwidth_control_value | 否 | Integer | 安全通道带宽控制量（Kbps）。取值范围为\[500-20000\]。默认：10000。 | 表68CameraBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | camera_bandwidth_control_value | 否 | Integer | 摄像头带宽控制量（Kbps）。取值范围为\[0-10000\]。默认：10000。 | 表69VirtualChannelBandwidthControlOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | virtual_channel_bandwidth_control_value | 否 | Integer | 虚拟通道带宽控制量（Kbps）。取值范围为\[500-20000\]。默认：20000。 | 表70custom | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | custom_configuration1_enable | 否 | Boolean | 自定义策略配置项1： false: 表示关闭 true: 表示开启 | | options | 否 | [CustomOptions] object | 自定义策略设置项。 | 表71CustomOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | custom_configuration1_rule | 否 | String | 配置项1内容。 | | rail_transparent_config | 否 | [RailTransparentConfig] object | 应用镜像策略设置项。 | 表72RailTransparentConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | select_policy | 否 | Integer | 策略选值原则。 | | transparent_list_custom | 否 | String | 配置项内容。 | 表73cloud_storage | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | cloud_storage_enable | 否 | Boolean | 云存储配置开关： false: 表示关闭 true: 表示开启 | | options | 否 | [CloudStorageOptions] object | 云存储配置。 | 表74CloudStorageOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | cloud_storage_rule | 否 | String | 配置项内容。 | 表75user_profile | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user_profile_enable | 否 | Boolean | 配置文件漫游技术配置开关： false: 表示关闭 true: 表示开启 | | options | 否 | [UpmOptions] object | 配置文件漫游技术配置。 | 表76UpmOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 允许自定义文件夹 | 表77url_redirection | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | url_redirection_enable | 否 | Boolean | 配置url重定向开关： false: 表示关闭 true: 表示开启 | | options | 否 | [UrlRedirectionOptions] object | url重定向配置。 | 表78UrlRedirectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | url_include_list | 否 | String | 允许重定向url。 | | url_exclude_list | 否 | String | 拒绝重定向url。 | 表79folder_redirection | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | folder_redirection_status | 否 | Integer | 配置文件夹重定向状态： 0: 已禁用 1: 已启用 2: 未配置 | | options | 否 | [FolderRedirectionOptions] object | 文件夹重定向配置。 | 表80FolderRedirectionOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | relative_path | 否 | String | 目标文件夹位置。 | | storage_paths | 否 | String | 用户存储路径。 | | include_common_folders | 否 | Integer | 文件夹选项。 | 表81folder_redirection_v2 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | folder_redirection_v2_status | 否 | Integer | 配置文件夹重定向状态： 0: 关闭 1: 已启用 | | options | 否 | [FolderRedirectionV2Options] object | 文件夹重定向配置(v2)。 | 表82FolderRedirectionV2Options | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | app_data_roaming_configurations | 否 | [AppDataRoamingConfigurations] object | "AppData(Roaming)"文件夹重定向配置 | | desktop_configurations | 否 | [DesktopConfigurations] object | "桌面"文件夹重定向配置 | | start_menu_configurations | 否 | [StartMenuConfigurations] object | "开始菜单"文件夹重定向配置 | | documents_configurations | 否 | [DocumentsConfigurations] object | "文档"文件夹重定向配置 | | pictures_configurations | 否 | [PicturesConfigurations] object | "图片"文件夹重定向配置 | | music_configurations | 否 | [MusicConfigurations] object | "音乐"文件夹重定向配置 | | videos_configurations | 否 | [VideosConfigurations] object | "视频"文件夹重定向配置 | | favorites_configurations | 否 | [FavoritesConfigurations] object | "收藏夹"文件夹重定向配置 | | contacts_configurations | 否 | [ContactsConfigurations] object | "联系人"文件夹重定向配置 | | downloads_configurations | 否 | [DownloadsConfigurations] object | "下载"文件夹重定向配置 | | links_configurations | 否 | [LinksConfigurations] object | "链接"文件夹重定向配置 | | searches_configurations | 否 | [SearchesConfigurations] object | "搜索"文件夹重定向配置 | | saved_games_configurations | 否 | [SavedGamesConfigurations] object | "保存的游戏"文件夹重定向配置 | 表83AppDataRoamingConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | app_data_roaming_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | app_data_roaming_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | app_data_roaming_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | app_data_roaming_relative_path | 否 | String | 目标文件夹位置。 | | app_data_roaming_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | app_data_roaming_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | app_data_roaming_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表84DesktopConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | desktop_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | desktop_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | desktop_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | desktop_relative_path | 否 | String | 目标文件夹位置。 | | desktop_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | desktop_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | desktop_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表85StartMenuConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | start_menu_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | start_menu_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | start_menu_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | start_menu_relative_path | 否 | String | 目标文件夹位置。 | | start_menu_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | start_menu_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | start_menu_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表86DocumentsConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | documents_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | documents_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | documents_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | documents_relative_path | 否 | String | 目标文件夹位置。 | | documents_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | documents_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | documents_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表87PicturesConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | pictures_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | pictures_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | pictures_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | pictures_relative_path | 否 | String | 目标文件夹位置。 | | pictures_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | pictures_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | pictures_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表88MusicConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | music_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | music_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | music_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | music_relative_path | 否 | String | 目标文件夹位置。 | | music_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | music_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | music_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表89VideosConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | videos_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | videos_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | videos_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | videos_relative_path | 否 | String | 目标文件夹位置。 | | videos_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | videos_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | videos_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表90FavoritesConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | favorites_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | favorites_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | favorites_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | favorites_relative_path | 否 | String | 目标文件夹位置。 | | favorites_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | favorites_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | favorites_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表91ContactsConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | contacts_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | contacts_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | contacts_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | contacts_relative_path | 否 | String | 目标文件夹位置。 | | contacts_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | contacts_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | contacts_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表92DownloadsConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | downloads_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | downloads_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | downloads_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | downloads_relative_path | 否 | String | 目标文件夹位置。 | | downloads_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | downloads_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | downloads_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表93LinksConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | links_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | links_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | links_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | links_relative_path | 否 | String | 目标文件夹位置。 | | links_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | links_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | links_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表94SearchesConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | searches_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | searches_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | searches_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | searches_relative_path | 否 | String | 目标文件夹位置。 | | searches_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | searches_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | searches_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表95SavedGamesConfigurations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | saved_games_status | 否 | Integer | 配置文件夹重定向状态： 0: 未选取 1: 已选取 | | saved_games_redirection_type | 否 | Integer | 配置文件夹重定向类型： 0: 远程 1: 本地 | | saved_games_storage_path | 否 | String | 文件夹重定向(v2)用户存储路径。 | | saved_games_relative_path | 否 | String | 目标文件夹位置。 | | saved_games_exclusive_rights | 否 | Integer | 是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启 | | saved_games_move_contents | 否 | Integer | 启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是 | | saved_games_move_content_on_policy_removal | 否 | Integer | 禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是 | 表96user_profile_management | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | upm_status | 否 | Integer | 用户配置状态： 0: 已禁用 1: 已启用 2: 未配置 | | options | 否 | [UserProfileManagementOptions] object | 用户漫游配置。 | 表97UserProfileManagementOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | profiles | 否 | [UserProfileManagementProfiles] object | 用户漫游profiles配置。 | 表98UserProfileManagementProfiles | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | vhd_write_back | 否 | String | 配置VHD会话回写状态： 0: 已禁用 1: 已启用 2: 未配置 | #### 响应参数 **状态码：200** 表99响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 策略组ID。 | **状态码：400** 表100响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：401** 表101响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：403** 表102响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：404** 表103响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：405** 表104响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：500** 表105响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | **状态码：503** 表106响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码，失败时返回。 | | error_msg | String | 错误描述。 | #### 请求示例 ``` POST /v1/29dfe82ada564ac2b927e1ff036d9a9b/policy-groups { "policy_group" : { "policy_group_name" : "test123", "description" : "", "policies" : { "peripherals" : { "usb_port_redirection" : { "usb_enable" : true, "options" : { "usb_image_enable" : true, "usb_video_enable" : true, "usb_printer_enable" : true, "usb_storage_enable" : false, "wireless_devices_enable" : false, "network_devices_enable" : false, "usb_smart_card_enable" : true, "other_usb_devices_enable" : false, "usb_redirection_customization_policy" : "", "usb_redirection_mode" : "Classical mode" } }, "device_redirection" : { "printer_redirection" : { "printer_enable" : true, "options" : { "sync_client_default_printer_enable" : true, "universal_printer_driver" : "Default" } }, "session_printer" : { "session_printer_enable" : false, "options" : { "session_printer_customization_policy" : "" } }, "camera_redirection" : { "video_compress_enable" : true, "options" : { "camera_frame_rate" : 15, "camera_max_width" : 3000, "camera_max_heigth" : 3000, "camera_compression_method" : "H.264" } }, "twain_redirection_enable" : true, "image_compression_level" : "medium" }, "usb_device_common" : { "pcsc_smart_card_enable" : "Disable", "common_options" : { "remove_smart_card_disconnect_enable" : false } }, "serial_port_redirection" : { "serial_port_enable" : false, "options" : { "auto_connect_enable" : false } } }, "audio" : { "audio_redirection_enable" : true, "play_redirection_enable" : true, "play_classification" : "Music Play", "record_redirection_enable" : true, "record_classification" : "Speech Call" }, "client" : { "automatic_reconnection_interval" : 5, "session_persistence_time" : 180, "forbid_screen_capture" : false }, "display" : { "display_level" : "LEVEL4", "options" : { "display_bandwidth" : 20000, "frame_rate" : 25, "video_frame_rate" : 30, "min_image_cache" : 200, "smoothing_factor" : 60, "lossless_compression_mode" : "Basic Compression", "deep_compression_options" : { "deep_compression_level" : "Compression grade 0" }, "lossy_compression_quality" : 85, "color_enhancement_enable" : false, "quality_bandwidth_first" : "Quality First", "video_bit_rate_options" : { "average_video_bit_rate" : 18000 }, "peak_video_bit_rate" : 18000, "video_quality_options" : { "average_video_quality" : 15, "lowest_video_quality" : 25, "highest_video_quality" : 7 }, "gop_size" : 100, "encoding_preset" : "Preset 1" }, "rendering_acceleration_enable" : true, "rendering_acceleration_options" : { "video_acceleration_enhancement_enable" : false, "video_optimization_enable" : false, "gpu_color_optimization_enable" : false }, "video_card_memory_size" : 64, "driver_delegation_mode_enable" : false, "driver_delegation_latency" : 80, "video_latency" : 80, "change_resolution_vm" : false }, "file_and_clipboard" : { "bypass_in_remote_app_enable" : true, "file_redirection" : { "redirection_mode" : "DISABLED", "options" : { "fluid_control_switch_enable" : false, "fluid_control_options" : { "good_network_latency" : 30, "normal_network_latency" : 70, "poor_network_latency" : 100, "reducing_step" : 20, "slow_increasing_step" : 10, "quick_increasing_step" : 20, "start_speed" : 1024, "test_block_size" : 64, "test_time_gap" : 10000 }, "compression_switch_enable" : false, "compression_switch_options" : { "compression_threshold" : 512, "minimum_compression_rate" : 900 }, "linux_file_size_supported_enable" : true, "linux_file_size_supported_options" : { "linux_file_size_supported_threshold" : 100 }, "linux_root_mount_switch_enable" : true, "linux_root_dir_list" : "\\var\\log", "linux_file_mount_path" : "\\media|\\Volumes|\\swdb\\mnt|\\home|\\storage|\\tmp|\\run\\media", "linux_fixed_drive_file_system_format" : "", "linux_removable_drive_file_system_format" : "vfat|ntfs|msdos|fuseblk|sdcardfs|exfat|fuse.fdredir", "linux_cdrom_drive_file_system_format" : "cd9660|iso9660|udf", "linux_network_drive_file_system_format" : "smbfs|afpfs|cifs", "path_separator" : "|", "fixed_drive_enable" : true, "removable_drive_enable" : true, "cd_rom_drive_enable" : true, "network_drive_enable" : true }, "vm_send_file_client" : false, "redirection_send_file_options" : { "read_write_speed" : 0 } }, "fd_mobile_client_redir_enable" : true, "clipboard_redirection" : "DISABLED", "clipboard_redirection_options" : { "rich_text_redirection_enable" : true, "rich_text_clipboard_redirection" : "DISABLED", "clipboard_file_redirection_enable" : true, "file_clipboard_redirection" : "DISABLED" } }, "session" : { "sbc" : { "sbc_automatic_disconnection" : "AUTO_DISCONNECT", "sbc_automatic_disconnection_options" : { "disconnection_waiting_time" : 15, "sbc_auto_logout" : true, "auto_logout_options" : { "sbc_logout_waiting_time" : 480 } } } }, "virtual_channel" : { "virtual_channel_control_enable" : false, "options" : { "custom_virtual_channel_name" : "", "virtual_channel_plugin_details" : "", "third_party_plugin_name" : "" } }, "keyboard_mouse" : { "mouse_feedback" : "SELFADAPTION", "mouse_simulation_mode" : "ABSOLUTE_POSITION", "external_cursor_feedback" : false }, "bandwidth" : { "intelligent_data_transport_flag" : "DISABLE", "total_bandwidth_control_enable" : false, "options" : { "total_bandwidth_control_value" : 30000, "display_bandwidth_percentage_enable" : false, "display_bandwidth_percentage_options" : { "display_bandwidth_percentage_value" : 65 }, "multimedia_bandwidth_percentage_enable" : false, "multimedia_bandwidth_percentage_options" : { "multimedia_bandwidth_percentage_value" : 50 }, "usb_bandwidth_percentage_enable" : false, "usb_bandwidth_percentage_options" : { "usb_bandwidth_percentage_value" : 100 }, "pcsc_bandwidth_percentage_enable" : false, "pcsc_bandwidth_percentage_options" : { "pcsc_bandwidth_percentage_value" : 5 }, "twain_bandwidth_percentage_enable" : false, "twain_bandwidth_percentage_options" : { "twain_bandwidth_percentage_value" : 15 }, "printer_bandwidth_percentage_enable" : false, "printer_bandwidth_percentage_options" : { "printer_bandwidth_percentage_value" : 5 }, "com_bandwidth_percentage_enable" : false, "com_bandwidth_percentage_options" : { "com_bandwidth_percentage_value" : 3 }, "file_redirection_bandwidth_percentage_enable" : false, "file_redirection_bandwidth_percentage_options" : { "file_redirection_bandwidth_percentage_value" : 30 }, "clipboard_bandwidth_percentage_enable" : false, "clipboard_bandwidth_percentage_options" : { "clipboard_bandwidth_percentage_value" : 3 }, "secure_channel_bandwidth_percentage_enable" : false, "secure_channel_bandwidth_percentage_options" : { "secure_channel_bandwidth_percentage_value" : 30 }, "camera_bandwidth_percentage_enable" : false, "camera_bandwidth_percentage_options" : { "camera_bandwidth_percentage_value" : 30 }, "virtual_channel_bandwidth_percentage_enable" : false, "virtual_channel_bandwidth_percentage_options" : { "virtual_channel_bandwidth_percentage_value" : 65 } }, "display_bandwidth_control_enable" : false, "display_bandwidth_control_options" : { "display_bandwidth_control_value" : 20000 }, "multimedia_bandwidth_control_enable" : false, "multimedia_bandwidth_control_options" : { "multimedia_bandwidth_control_value" : 15000 }, "usb_bandwidth_control_enable" : false, "usb_bandwidth_control_options" : { "usb_bandwidth_control_value" : 30000 }, "pcsc_bandwidth_control_enable" : false, "pcsc_bandwidth_control_options" : { "pcsc_bandwidth_control_value" : 2000 }, "twain_bandwidth_control_enable" : false, "twain_bandwidth_control_options" : { "twain_bandwidth_control_value" : 5000 }, "printer_bandwidth_control_enable" : false, "printer_bandwidth_control_options" : { "printer_bandwidth_control_value" : 2000 }, "com_bandwidth_control_enable" : false, "com_bandwidth_control_options" : { "com_bandwidth_control_value" : 1000 }, "file_redirection_bandwidth_control_enable" : false, "file_redirection_bandwidth_control_options" : { "file_redirection_bandwidth_control_value" : 10000 }, "clipboard_bandwidth_control_enable" : false, "clipboard_bandwidth_control_options" : { "clipboard_bandwidth_control_value" : 1000 }, "secure_channel_bandwidth_control_enable" : false, "secure_channel_bandwidth_control_options" : { "secure_channel_bandwidth_control_value" : 10000 }, "camera_bandwidth_control_enable" : false, "camera_bandwidth_control_options" : { "camera_bandwidth_control_value" : 10000 }, "virtual_channel_bandwidth_control_enable" : false, "virtual_channel_bandwidth_control_options" : { "virtual_channel_bandwidth_control_value" : 20000 } }, "custom" : { "custom_configuration1_enable" : true, "options" : { "custom_configuration1_rule" : "" } } } } } ``` #### 响应示例 **状态码：200** 创建策略组成功响应。 ``` { "id" : "8885bcc45d547b41015d547d227e0000" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 创建策略组成功响应。 | | 400 | 由于包含语法错误，当前请求无法被服务器理解。 | | 401 | 鉴权失败。 | | 403 | 没有操作权限。 | | 404 | 找不到资源。 | | 405 | 请求中指定的方法不被允许。 | | 500 | 服务内部错误，具体返回错误码请参见错误码说明。 | | 503 | 服务不可用。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-workspace/ErrorCode_0.html)。