文档

ModifyPolicyGroup - 修改策略

更新时间:

修改策略。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。

cn-hangzhou
PolicyGroupIdstring

策略 ID。

pg-gx2x1dhsmthe9****
Namestring

策略名称。

testPolicyGroupName
Clipboardstring

剪贴板权限。取值范围:

  • read:只读。可以将本地内容复制到云桌面,不能将云桌面内容复制到本地。
  • readwrite:读写。可以将本地内容复制到云桌面,也可以将云桌面内容复制到本地。
  • off:关闭。云桌面和本地之间无法进行复制操作。

默认值是 off。

off
LocalDrivestring

本地磁盘映射权限。取值范围:

  • read:只读。云桌面上有本地磁盘的映射,但是只能读取(复制)本地文件,不能修改本地文件。
  • readwrite:读写。云桌面上有本地磁盘的映射,可以读取(复制)本地文件,也可以修改本地文件。
  • off:关闭。云桌面上没有本地磁盘的映射。
off
UsbRedirectstring

USB 重定向。取值范围:

  • on:开启
  • off:关闭
off
VisualQualitystring

图像显示质量策略。取值范围:

  • low:流畅
  • medium:自适应
  • high:高清
  • lossless:无损

默认值是 medium。

low
Html5Accessstring

HTML5 客户端访问策略。取值范围:

  • on:允许
  • off:禁止

默认值是 off。

说明 推荐您使用 ClientType 相关参数统一管控登录方式。
off
Html5FileTransferstring

HTML5 客户端文件传输策略。取值范围:

  • off:关闭
  • upload:允许上传
  • download:允许下载
  • all:允许上传下载

默认值是 off。

off
Watermarkstring

水印。取值范围:

  • on:开启
  • off:关闭
off
WatermarkTypestring

水印类型。支持同时选择多个类型,用英文逗号隔开。取值范围:

  • EndUserId:显示用户名。
  • HostName:显示云桌面 ID 的后 15 位。
EndUserId
WatermarkTransparencystring

水印显示的深浅程度。取值范围:

  • LIGHT
  • MIDDLE
  • DARK
LIGHT
PreemptLoginstring

桌面抢占策略。默认为 off,不支持修改。

off
DomainListstring

管控访问域名权限,域名支持*通配符,多个域名之间以英文逗号隔开。取值范围:

  • off:关闭。
  • on:开启。
on
PrinterRedirectionstring

打印机重定向。取值范围:

  • off:关闭

  • on:打开

off
PreemptLoginUserarray

可抢占桌面的一组用户的用户名,最多可以设置 5 个。

说明 为保证正在使用云桌面的终端用户的操作体验和数据安全,暂不允许多个用户之间互相抢占。
string

可抢占桌面的用户的用户名。

Alice
AuthorizeSecurityPolicyRuleobject []

安全组管控规则数组。

Typestring

安全组管控规则的规则方向。取值范围:

  • inflow:入方向
  • outflow:出方向
inflow
Policystring

安全组管控规则的授权策略。取值范围:

  • accept:允许策略,接收所有访问请求。
  • drop:拒绝策略,拒绝所有访问请求。不返回拒绝信息,表现为发起端请求超时或者无法建立连接。
accept
PortRangestring

安全组管控规则的端口范围。由协议(IpProtocol)的取值确定端口的取值范围:

  • TCP 协议或者 UDP 协议:端口取值范围为 1~65535。使用斜线(/)隔开起始端口和终止端口。例如:1/200。
  • ICMP 协议:端口为-1/-1。
  • GRE 协议:端口为-1/-1。
  • IpProtocol 取值为 all:端口为-1/-1。

典型应用的常用端口请参见常用端口

22/22
Descriptionstring

安全组管控规则的描述信息。

test
IpProtocolstring

安全组管控规则的协议类型。取值范围:

  • tcp:TCP 协议
  • udp:UDP 协议
  • icmp:ICMP(IPv4)协议
  • gre:GRE 协议
  • all:支持所有协议
tcp
Prioritystring

安全组管控规则的优先级。数字越小,代表优先级越高。
取值范围:1~60。
默认值:1。

1
CidrIpstring

安全组管控规则的对象,CIDR 格式的 IPv4 地址段。

10.0.XX.XX/8
RevokeSecurityPolicyRuleobject []

待删除安全组管控规则数组。

Typestring

待删除安全组管控规则的规则方向。取值范围:

  • inflow:入方向
  • outflow:出方向
outflow
Policystring

待删除安全组管控规则的授权策略。取值范围:

  • accept:允许策略,接收所有访问请求。
  • drop:拒绝策略,拒绝所有访问请求。不返回拒绝信息,表现为发起端请求超时或者无法建立连接。

默认值:accept。

accept
PortRangestring

待删除安全组管控规则的端口范围。由协议(IpProtocol)的取值确定端口的取值范围:

  • TCP 协议或者 UDP 协议:端口取值范围为 1~65535。使用斜线(/)隔开起始端口和终止端口。例如:1/200。
  • ICMP 协议:端口为-1/-1。
  • GRE 协议:端口为-1/-1。
  • IpProtocol 取值为 all:端口为-1/-1。

典型应用的常用端口请参见常用端口

22/22
Descriptionstring

待删除安全组管控规则的描述信息。

test
IpProtocolstring

待删除安全组管控规则的协议类型。取值范围:

  • TCP:TCP 协议
  • UDP:UDP 协议
  • ICMP:ICMP(IPv4)协议
  • GRE:GRE 协议
  • ALL:支持所有协议
tcp
Prioritystring

待删除安全组管控规则的优先级。数字越小,代表优先级越高。
取值范围:1~60。
默认值:1。

1
CidrIpstring

待删除安全组管控规则的对象,CIDR 格式的 IPv4 地址段。

47.100.XX.XX/16
AuthorizeAccessPolicyRuleobject []

客户端 IP 白名单数组。

Descriptionstring

客户端 IP 白名单的描述信息。

test
CidrIpstring

客户端访问 IP 地址段。格式为 CIDR 格式的 IPv4 地址段。

47.100.XX.XX/16
RevokeAccessPolicyRuleobject []

待删除客户端 IP 白名单数组。

Descriptionstring

待删除客户端 IP 白名单的描述信息。

test
CidrIpstring

待删除客户端访问 IP 地址段。格式为 CIDR 格式的 IPv4 地址段。

47.100.XX.XX/16
ClientTypeobject []

登录方式管控数组。

ClientTypestring

登录方式管控,设置客户端类型。取值范围:

  • windows:Windows 客户端
  • linux:阿里云云终端
  • macos:macOS 客户端
  • ios:iOS 客户端
  • android:Android 客户端
  • html5:Web 客户端
说明 如果不设置 ClientType 相关参数,则默认允许所有类型的客户端登录云桌面。
windows
Statusstring

登录方式管控,设置是否允许使用某一类型的客户端登录云桌面。取值范围:

  • on:允许
  • off:不允许
说明 如果不设置 ClientType 相关参数,则默认允许所有类型的客户端登录云桌面。
ON
GpuAccelerationstring

是否为图形型规格云桌面开启画质策略。对桌面性能和使用体验要求较高时,例如专业设计场景下,建议开启该策略。取值范围:

  • on:开启
  • off:关闭
off
UsbSupplyRedirectRuleobject []

USB 重定向规则。

VendorIdstring

生产厂商 ID。参见Valid USB Vendor IDs (VIDs)

04**
ProductIdstring

产品 ID。

08**
Descriptionstring

规则描述。

测试规则
UsbRedirectTypelong

USB 重定向类型。取值范围:

  • 1:允许
  • 2:拒绝
1
DeviceClassstring

设备类别,当usbRuleType为 1 的时候需要填写。参见Defined Class Codes

0Eh
DeviceSubclassstring

设备子类别,当usbRuleType为 1 的时候需要填写。参见Defined Class Codes

xxh
UsbRuleTypelong

USB 重定向规则类型。取值范围:

  • 1:设备类别
  • 2:设备厂商
1
DomainResolveRuleTypestring

DNS 策略类型。

OFF
DomainResolveRuleobject []

域名解析策略详情。

Domainstring

域名

*.igetget.com
Policystring

策略类型。

枚举值:
  • allow允许
  • block拒绝
allow
Descriptionstring

策略描述。

策略描述。
Recordingstring

是否开启录屏。取值范围:

  • OFF:不开启录屏。
  • ALLTIME:全程录屏,从登录桌面开始到退出桌面。
  • PERIOD:间隔录屏,需设置录屏开始和结束时间。
OFF
RecordingStartTimestring

录屏开始时间,取值:HH:MM:SS。只有 Recording 取值是 PERIOD 时,该返回值有实际意义。

08:00:00
RecordingEndTimestring

录屏结束时间,取值:HH:MM:SS。只有 Recording 取值是 PERIOD 时,该返回值有实际意义。

08:59:00
RecordingFpslong

录屏帧数。取值范围:

  • 2
  • 5
  • 10
  • 15
5
RecordingExpireslong

录屏审计过期时间。取值范围 15-180 天。

30
NetRedirectstring

网络重定向,取值范围:

  • on: 开启
  • off: 关闭

默认值是 off。

说明 该功能处于定向邀测中,暂不对外开放。
on
CameraRedirectstring

是否开启本地摄像头重定向。取值范围:

  • on:开启
  • off:关闭

默认值是 on。

on
AppContentProtectionstring

是否开启防截屏功能。取值范围:

  • on:开启
  • off:关闭

默认值是 off。

on
RecordContentstring

是否开启自定义录屏。取值范围:

  • on:开启
  • off:关闭

默认值是 off。

OFF
RecordContentExpireslong

自定义录屏的文件过期时间,默认 30 天。

30
RemoteCoordinatestring

远程协助键鼠控制权限,取值范围:

  • fullControl:完全控制。
  • optionalControl:默认关闭,可以申请打开。
  • disableControl:不控制。
fullControl
RecordingDurationinteger

与 Recording 配合使用,录屏指定时长后生成录屏文件。

15
Scopestring

策略的生效范围。取值范围:

  • GLOBAL:全局生效。
  • IP:根据 IP 生效。
GLOBAL
ScopeValuearray

Scope 取值为 IP 的时候填写。

string

生效的 cidr block。

47.100.XX.XX/24
RecordingAudiostring

录制桌面声音选项,取值范围:

  • on:音画同期录制。
  • off:仅录制画面不录制声音。
枚举值:
  • off关闭声音录制[默认选项]
  • on开启声音录制
on
InternetCommunicationProtocolstring

网络通信协议。取值范围:

  • TCP:只允许使用 TCP。
  • BOTH:允许自动在 TCP 和 UDP 之间切换。

默认值:TCP。

BOTH
VideoRedirectstring

多媒体重定向。

on
WatermarkTransparencyValueinteger

水印透明度,值越大,透明度越小。 取值范围:10~100。

10
WatermarkColorinteger

水印字体颜色。 取值范围:0~16777215

0
WatermarkDegreedouble

水印倾斜度。取值范围:-10~-30 。

-10
WatermarkFontSizeinteger

水印字体大小。 取值范围:10~20。

10
WatermarkFontStylestring

水印字体样式。 取值范围:

  • plain:普通。
  • bold:加粗。
plain
WatermarkRowAmountinteger

水印行数,暂不生效。

3
EndUserApplyAdminCoordinatestring

用户申请管理员协助开关,取值范围: on:开启。 off:关闭。

on
EndUserGroupCoordinatestring

用户之间流协同开关,取值范围: on:开启。 off:关闭。

on
WatermarkSecuritystring

盲水印安全优先规则,取值范围: on:开启。 off:关闭。

off
AdminAccessstring

用户登录桌面后是否具有管理员权限

说明 该功能处于定向邀测中,暂不对外开放。
deny
WatermarkAntiCamstring

盲水印防拍照功能,取值范围: on:开启。 off:关闭。

off
WatermarkPowerstring

盲水印增强功能,取值范围: low:低。 medium:中。 high:高。

medium
RecordingUserNotifystring

录屏客户端消息通知功能,取值范围: on:开启。 off:关闭。

off
RecordingUserNotifyMessagestring

录屏客户端通知内容。默认无需填写。

您的桌面正在被录屏

返回参数

名称类型描述示例值
object

返回对象。

RequestIdstring

请求 ID。

1CBAFFAB-B697-4049-A9B1-67E1FC5F****

示例

正常返回示例

JSON格式

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-01-26OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:WatermarkAntiCam
    新增入参:WatermarkPower
    新增入参:RecordingUserNotify
    新增入参:RecordingUserNotifyMessage
2024-01-05OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:AdminAccess
2023-09-20OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:WatermarkSecurity
2023-07-31OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:DomainResolveRuleType
    新增入参:DomainResolveRule
2022-11-04OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:RecordingAudio
2022-10-08OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:RecordingDuration
2022-01-11OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:Recording
    新增入参:RecordingStartTime
    新增入参:RecordingEndTime
    新增入参:RecordingFps
    新增入参:CameraRedirect
2021-11-30OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:GpuAcceleration
  • 本页导读 (0)
文档反馈