策略组-华为云

云桌面 WORKSPACE-查询接入策略:响应示例

响应示例状态码： 200 正常。 { "policies" : [ { "policy_id" : "8ac225c2781edb0d01781edde3f4xxxx", "create_time" : "2022-10-24T17:24:56.000+00:00", "policy_name" : "PRIVATE_AC CES S", "blacklist_type" : "INTERNET" } ], "total" : 1 }

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-查询接入策略:URI

URI GET /v2/{project_id}/access-policy 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目id。表2 Query参数参数是否必选参数类型描述 access_control_type 否 String 接入策略控制类型 ACCESS_TYPE：接入类型 IP_WHITE_LIST： IP白名单 limit 否 Integer 每页数量,范围0-100,默认100。 offset 否 Integer 偏移量,范围0-99,默认0。

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-查询接入策略:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 policies Array of AccessPolicyDetailInfo objects 查询接入策略响应。 total Integer 策略总数。表5 AccessPolicyDetailInfo 参数参数类型描述 policy_name String 策略名 blacklist_type String 黑名单类型，当前黑名单只支持互联网。 INTERNET：互联网 access_control_type String 访问控制类型。默认为接入类型 ACCESS_TYPE：接入类型 IP_WHITE_LIST： IP白名单 ip_list Array of IpInfo objects 策略的ip列表。 ip_total_count Integer 策略总数。 policy_id String 策略id。 create_time String 接入策略创建的时间。表6 IpInfo 参数参数类型描述 ip_address String ip地址。 subnet_mask String 子网掩码。状态码： 400 表7 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。状态码： 401 表8 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。状态码： 403 表9 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。状态码： 404 表10 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。状态码： 405 表11 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。状态码： 500 表12 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。状态码： 503 表13 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-配置高级策略参数:会话

会话会话策略配置如表6所示。表6 会话策略策略参数策略说明推荐值无键鼠事件自动断开自动断开：客户端中无键鼠操作超过设置的等待时间后，将自动断开与服务器的连接，关闭应用。已禁用：关闭自动断开功能禁用。自动断开等待时间（分钟）无键鼠事件自动断开的等待时间设置。配置范围：3~86400 15 自动注销开启无键鼠事件自动断开功能后，可配置在断开多久后自动注销会话。启用会话断连保留时长（分钟）无键鼠事件自动断开功能开启后，自动断开连接后，等待设置的会话保留时长后，自动注销会话。配置范围：1~86400。 480

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-配置高级策略参数:文件和剪切板

文件和剪切板配置文件和剪切板策略。策略内容如表5所示。表5 文件和剪切板策略策略类型策略参数策略说明取值样例双向重定向双向重定向开关在云桌面内使用云应用时，默认开启文件重定向和剪切板重定向（双向），实现云桌面和云应用之间在云上内网间互相拷贝数据。在TC或者本地桌面使用云应用时，根据文件重定向和剪切板重定向的开关配置控制文件和剪切板的数据拷贝。文件重定向文件重定向开关只读，对选择的驱动器和存储设备中的文件只可以预览。读写，对选择的驱动器存储设备中的文件可编辑修改。在云应用环境下实现对驱动器的支持，用户可以在云应用中通过文件重定向方式使用驱动器。只读固定驱动器：选择后用户可以在云应用中通过文件重定向方式使用固定驱动器，如本地磁盘。：未选择则用户无法在云应用中通过文件重定向方式使用固定驱动器，如本地磁盘。说明：文件重定向关闭时，为禁用。可移除驱动器：选择后用户可以在云应用中通过文件重定向方式使用可移除驱动器，如U盘。：未选择则用户无法在云应用中通过文件重定向方式使用可移除驱动器，如U盘。说明：文件重定向关闭时，为禁用。光盘驱动器：选择后用户可以在云应用中通过文件重定向方式使用光盘驱动器。：未选择则用户无法在云应用中通过文件重定向方式使用光盘驱动器。网络驱动器：选择后用户可以在云应用中通过文件重定向方式使用网络驱动器。：未选择则用户无法在云应用中通过文件重定向方式使用网络驱动器。文件发送（虚拟机至客户端）：启用文件发送开关。：关闭文件发送开关。流控开关：启用流控开关。：关闭流控开关。网络优的延时阈值（ms）网络优良时的延时阈值，取值范围1~1000。 30 网络一般的延时阈值（ms）网络一般时的延时阈值，取值范围1~1000。 70 网络差的延时阈值（ms）网络较差时的延时阈值，取值范围1~1000。 100 降速步伐（KB）降低传输速度的步伐，取值范围1~100。 20 慢增速步伐（KB）慢增加传输速度的步伐，取值范围1~100。 10 快增速步伐（KB）快增加传输速度的步伐，取值范围1~100。 20 传输初始速度（KB/s）初始的开始传输速度，取值范围1~10240。 1024 测速块大小（KB）测试速度的数据块大小，取值范围64~1024。 64 测速块时间间隔（ms）发送测试数据块的时间间隔，取值范围1000~100000。 10000 压缩开关：启用压缩开关。：关闭压缩开关。压缩阈值（Byte）取值范围0~10240。 512 最小压缩率取值范围0~1000。 900 Linux支持设置文件大小：启用Linux支持设置文件大小。：关闭Linux支持设置文件大小。 Linux设置文件大小阈值（MB）取值范围0~4096。 100 Linux根目录挂载开关：启用Linux根目录挂载。：关闭Linux根目录挂载。 Linux根目录挂载路径启用Linux根目录挂载时需配置挂载路径。最长256个字符，字符串格式UTF-8。 \var\log Linux文件系统挂载路径最长256个字符，字符串格式UTF-8。 \media|\Volumes|\swdb\mnt|\home|\storage|\tmp|\run\media Linux固定驱动器文件系统格式最长256个字符，字符串格式UTF-8。 - Linux可移动驱动器文件系统格式最长256个字符，字符串格式UTF-8。 vfat|ntfs|msdos|fuseblk|sdcardfs|exfat|fuse.fdredir Linux光盘驱动器文件系统格式最长256个字符，字符串格式UTF-8。 cd9660|iso9660|udf Linux网络驱动器文件系统格式最长256个字符，字符串格式UTF-8。 smbfs|afpfs|cifs 路径分隔符单个ASCII字符。 | 读写速度（Kbps）范围大小为0~2147483647之间。 0 移动客户端重定向：启用移动客户端重定向。：关闭移动客户端重定向。剪切板重定向剪切板重定向开启双向：启用后最终用户可以在云应用客户端复制数据并在本地桌面中粘贴，同时也可以在本地桌面中复制数据后在云应用客户端中粘贴。服务端到客户端：启用后最终用户只支持在云应用客户端中复制数据并在本地桌面中粘贴。客户端到服务端：启用后，只支持在本地桌面中复制数据并在云应用客户端中粘贴。纯文本长度限制允许服务端到客户端拷贝，范围为1~4096个字符。允许客户端到服务端拷贝，范围为1~4096个字符。说明：仅在客户端（TC/SC）操作系统和云应用操作系统均为Windows时，支持富文本拷贝、文件拷贝，且最多同时可拷贝500个文件。当客户端（TC/SC、移动客户端）操作系统为其他时，只支持纯文本格式拷贝，不支持文件拷贝。开启双向剪切板富文本重定向开启双向：启用后最终用户可以在云应用客户端复制富文本并在本地桌面中粘贴，同时也可以在本地桌面中复制富文本后在云应用客户端中粘贴。服务端到客户端：启用后最终用户只支持在云应用客户端中复制富文本并在本地桌面中粘贴。客户端到服务端：启用后，只支持在本地桌面中复制富文本并在云应用客户端中粘贴。说明：富文本：指包含了格式信息的文本，比如字体样式（粗体、斜体等）、颜色、超链接、图像、表格等多媒体元素。开启双向剪切板文件重定向开启双向：启用后最终用户可以在云应用客户端复制文件并在本地桌面中粘贴，同时也可以在本地桌面中复制文件后在云应用客户端中粘贴。服务端到客户端：启用后最终用户只支持在云应用客户端中复制文件并在本地桌面中粘贴。客户端到服务端：启用后，只支持在本地桌面中复制文件并在云应用客户端中粘贴。开启双向

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-配置高级策略参数:显示

显示配置显示策略，策略配置内容如表4所示。表4 显示策略策略类型策略参数策略说明取值样例显示显示策略等级等级1：适用于512Kbps以下的网络带宽，仅用于浏览文本文档等轻载办公场景，显示质量较低。等级2：适用于1Mbps以下的网络带宽，仅用于浏览文本文档及静态图片等轻载办公场景，显示质量略优于等级1。等级3：适用于4Mbps以下的网络带宽，可用于浏览文档、图片、动态网页等中载办公场景。等级4（推荐）：适用于20Mbps以下的网络带宽，可用于流畅播放标清/高清视频，显示质量与占用带宽达到更佳平衡。等级5：适用20Mbps以上的网络带宽，视频播放效果最优。等级4（推荐）显示帧率（fps）非视频场景下的画面刷新率。该值越大，则画面与操作越流畅，但所需的网络带宽以及虚拟机的CPU占用率也会随之升高。取值范围1~60，推荐配置为15~25。 25 视频帧率（fps）视频场景下的画面刷新率。该值越大，则视频播放越流畅，但所需的网络带宽以及虚拟机的CPU占用率也会随之升高。 - 带宽（Kbps）单用户峰值带宽限制，取值范围256~25000。 20000 图像压缩参数图像缓存最低容量（MB）进行图像缓存时的缓存容量的大小，单位MB。值越大，带宽越低，但会消耗客户端内存。设定值小于50时，缓存功能停用。取值范围0~300。 200 有损压缩识别阈值图像复杂度的判别阈值。该值越小，图像越倾向于无损画质，清晰度越高，但对网络带宽要求也相应升高，反之亦然，取值范围0~255。 60 无损压缩模式选择无损图像压缩算法，“初级压缩”的压缩率较低，CPU占用也低；而“深度压缩”则相反，压缩率较高，但CPU占用也略微升高。初级压缩深度压缩级别该项在选择“深度压缩”后生效。压缩级别越高，意味着压缩比越高，带宽占用越低，而CPU占用越高。0级压缩表示原图拷贝，无压缩，CPU占用最低，但带宽占用最高。压缩级别0 有损压缩质量该项用于设置有损压缩的图像质量。取值越大，画质越好。取值范围20~100。 85 办公场景色彩增强该项用于办公场景色彩增强。：启用办公场景色彩增强。：禁用办公场景色彩增强。视频压缩参数质量或带宽优先质量优先：选择质量优先，则以固定质量压缩视频画面。“视频平均码率”不生效，仅在启用“渲染加速”后生效。带宽优先：选择带宽优先，则以恒定码率压缩视频画面。 “视频平均质量”、“视频最低质量”、“视频最高质量”不生效，仅在启用“渲染加速”后生效。质量优先视频平均码率（Kbps）视频压缩算法参数。在带宽优先模式下，该值越大，视频质量越好。取值范围256~100000。 18000 视频峰值码率（Kbps）视频压缩算法参数。该值越大，视频质量越好。取值范围256~100000。 18000 视频平均质量视频画面的平均质量系数。在质量优先模式下，该值越大，视频质量越差。取值范围5~59。 15 视频最低质量视频画面的质量下限。在质量优先模式下，该值越大，视频质量越差。取值范围5~69。 25 视频最高质量视频画面的质量上限。在质量优先模式下，该值越大，视频质量越差。取值范围1~59。 7 GOP大小视频压缩算法参数。该值越小，视频质量越好，但带宽占用越大，推荐设为视频帧率的1~2倍。取值范围0~65535。 100 编码预置视频压缩算法参数。该值越小，编码速度越快，流畅度越好，但图像质量越差，带宽越大。预置1 渲染加速渲染加速：选择后启用渲染加速模式，提高显示流畅度。：未选择则禁用渲染加速。视频加速增强配置：启用视频加速增强配置。：禁用视频加速增强配置。视频场景优化：启用视频场景优化，提高视频场景的显示流畅度。：禁用视频场景优化。 GPU色彩优化：启用GPU色彩优化，在视频/办公混合场景中提高色彩还原度。：禁用GPU色彩优化。说明：该参数仅针对GPU桌面。其他参数显卡缓存（MB）设备表面内存容量，取值范围0~64，影响部分场景带宽，值越大，带宽越低。 64 驱动托管模式：启用驱动托管模式。：禁用驱动托管模式。驱动托管延时（*30ms）取值范围1~100。 80 驱动托管视频延时（*30ms）取值范围1~100。 80 计算机修改分辨率：启用计算机修改分辨率策略后，终端用户可在云应用客户端中通过系统设置的方式修改云应用客户端显示分辨率。：禁用计算机修改分辨率，终端用户不能通过系统设置的方式修改显示分辨率。

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-配置高级策略参数:客户端

客户端配置客户端策略。策略内容如表3所示。表3 客户端策略策略参数策略说明取值样例自动重连间隔（秒）在云应用客户端异常断开连接后，每隔多长时间尝试连接一次。取值范围为1~50。 5 自动重连会话保持时长（秒）在云应用客户端异常断开连接后，自动重连最多尝试的时间。取值范围为0~180。 180 防截屏策略策略开启后，防止用户在云应用客户端截屏保存本地及分享。启用防截屏策略开关。关闭防截屏策略开关。说明：仅支持windows客户端、Linux瘦终端，开启后其他终端会禁止接入。

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-配置高级策略参数:音频

音频配置音频策略。策略内容如表2所示。表2 音频策略策略项策略参数策略说明取值样例音频重定向音频重定向总开关用户云应用客户端上的应用程序可以通过终端上的声音设备来录音和播音。播音重定向播音重定向总开关只有在设置启用音频重定向后才生效。单独控制播音开关。：启用播音重定向。启用后最终用户可以可正常播音。：禁用播音重定向。最终用户播音时系统将无声。播音场景无损：音质最好，但是带宽占用最高。语音通话：选择该场景能提供更佳的语音通话处理能力而且带宽占用最低，但音乐处理能力一般。音乐播音：选择该场景能提供更佳的音乐处理效果且带宽占用适中，但语音通话处理能力一般。自动识别：选择该场景能识别用户当前是在语音通话还是在播放音乐（正常自动识别准确率可高于90%）。系统会根据用户的行为自动切换到更佳算法。音乐播音录音重定向录音重定向总开关该策略项只有在设置启用音频重定向后才生效，单独控制录音开关。：启用录音重定向。启用后最终用户可以正常录音。：禁用录音重定向。最终用户录音时系统将无声。录音场景无损：音质最好，但是带宽占用最高。用户在网络带宽充足和网络稳定可靠的情况才建议选择该场景。录音通常不建议使用。语音通话：此选择能提供更佳的语音通话处理能力而且带宽占用最低，但音乐处理能力一般。录音基本上都是用于录语音，建议用户选择该场景。音乐录音：保留项。录音实践应用中很少用于音乐。录音通常不建议使用该场景。自动识别：保留项。自动识别目前等同于选择语音通话场景。语音通话

云桌面 WORKSPACE 策略组

云桌面 WORKSPACE-创建策略组:操作步骤

操作步骤使用管理员帐号登录云应用的管理控制台。在左侧导航栏中单击“策略组”，进入策略组列表页面。在页面右上角单击“创建策略组”，进入创建策略组基础信息配置页面。设置“策略名称”和“描述”信息。 “策略名称”必须由半角数字、字母和下划线组成，输入长度不可超过55个字符。描述字数最多支持255个。根据实际需求，选择“创建模式”。全新创建：使用空的默认模板创建。从模板创建：使用现有的策略模板创建，配置项默认与该策略模板相同。管理员可以选择已存在的策略模板或者通过新增自定义模板创建新的模板。系统已提供四种不同场景的策略模板。帮助您快速完成云应用策略配置。安全场景：安全场景下，通过华为云桌面协议禁止云应用中的数据流出到个人存储设备，确保数据资产只保留在企业的数据中心。游戏场景：针对游戏场景，优化鼠标的跟随性和画面显示，在带宽有限的场景下，优先保证流畅度，提升游戏体验。制图场景：针对制图场景，调整显示帧率，提升画面的显示质量；调整鼠标跟随模式，降低光标与图片之间的间隔，减少用户的视觉差异。视频编辑场景：针对视频编辑场景，通过视频加速，优化视频播放质量，鼠标紧密跟随用户操作，提升用户操作体验。导入已有策略：如果已经创建过策略，可在已有的策略中选择策略导入，配置项默认与选择的该策略相同。单击“下一步：策略配置”。进入通用策略配置页面。在“通用策略配置”页面中，根据用户的实际场景需求，设置计算机各方面的应用策略。通用策略精简自高级策略，可以满足常用办公需求。已默认开启满足常用办公需求的策略参数项。表示该项策略已启用。表示该项策略已禁用。通用策略配置的策略内容如表1 策略管理所示。表1 策略管理策略类型策略参数策略说明文件重定向固定驱动器只读，对驱动器和存储设备中的文件只可以预览。读写，对驱动器存储设备中的文件可编辑修改。在云应用环境下实现对驱动器的支持，用户可以在虚拟机中通过文件重定向方式使用驱动器。可移除驱动器光盘驱动器网络驱动器剪切板重定向开启双向启用后最终用户可以在云应用中复制数据并在本地桌面中粘贴，同时也可以在本地桌面中复制数据后在云应用中粘贴。服务端到客户端启用后最终用户只支持在云应用中复制数据并在本地桌面中粘贴。客户端到服务端启用后，只支持在本地桌面中复制数据并在云应用中粘贴。说明：文件拷贝操作只支持使用Windows客户端到服务端，且需要开启文件重定向及对应驱动器。打印机设备重定向服务端到客户端用户可以使用TC上连接的打印机设备会话配置无键鼠事件自动断开自动断开：客户端中无键鼠操作超过设置的等待时间后，将自动断开与服务器的连接，关闭应用。已禁用：关闭自动断开功能禁用。等待时间（分钟）无键鼠事件自动断开的等待时间设置。配置范围：3~86400 自动注销开启无键鼠事件自动断开功能后，可配置在断开多久后自动注销会话。会话断连保留时长（分钟）无键鼠事件自动断开功能开启后，自动断开连接后，等待设置的会话保留时长后，自动注销会话。配置范围：1~86400。配置高级策略。通用策略配置可以满足常用办公需求，如有特殊场景需求，可进行“高级策略”配置。在通用策略配置页面，单击“高级策略”。进入“高级策略”配置页面。图1 高级策略配置入口根据场景需求，配置高级策略。如图2 高级策略配置所示，高级策略配置参数请参考配置高级策略参数。图2 高级策略配置单击“下一步：应用对象”。按实际情况选择“对象类型”，选择对象，如图3所示。所有对象用户用户组应用组图3 选择应用对象单击“下一步：完成”。创建策略成功，策略会在用户下一次登录云应用客户端后生效。

云桌面 WORKSPACE 管理策略组

云服务器内容精选

策略组

7*24

备案

专业服务

退订

建议反馈

售前咨询热线