AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 无影云电脑企业版 开发参考 API参考（云电脑管控） API目录 策略 无地域策略 CreateCenterPolicy - 创建无地域策略

CreateCenterPolicy - 创建无地域策略

更新时间：
产品详情
我的收藏

创建一条无地域的云电脑策略。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用前面加 * 表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecd:CreateCenterPolicynone
*全部资源
*
    无
无

请求参数

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

地域 ID。该功能无地域属性，该字段固定填写 cn-shanghai。

枚举值：
  • cn-shanghai：华东2（上海）。
cn-shanghai
ResourceTypestring是

资源类型。

枚举值：
  • app：云应用。
  • desktop：云电脑。
desktop
BusinessTypeinteger是

业务类型。

枚举值：
  • 1：公共云。
  • 8：商业版。
1
Clipboardstring否

剪贴板权限。

枚举值：
  • read：单向允许。可以将本地内容复制到云电脑，不能将云电脑内容复制到本地。
  • readwrite：双向允许。可以将本地内容复制到云电脑，也可以将云电脑内容复制到本地。
  • write：单向允许。可以将云电脑内容复制到本地，不能将本地内容复制到云电脑。
  • off：双向禁止。云电脑和本地之间无法进行复制操作 [默认值]。
off
LocalDrivestring否

本地磁盘映射权限。

枚举值：
  • read：只读。云电脑上有本地磁盘的映射，但是只能读取（复制）本地文件，不能修改本地文件。
  • readwrite：读写。云电脑上有本地磁盘的映射，可以读取（复制）本地文件，也可以修改本地文件。
  • off：关闭。云电脑上没有本地磁盘的映射 [默认值]。
off
UsbRedirectstring否

USB 重定向。

枚举值：
  • off：关闭 [默认值]。
  • on：开启。
off
PrinterRedirectstring否

打印机重定向策略。当 DeviceRedirects 中没有打印机重定向策略时生效。

枚举值：
  • deviceRedirect：设备重定向[默认值]。
  • usbRedirect：USB重定向。
  • off：关闭。
off
VisualQualitystring否

图像显示质量策略。

枚举值：
  • high：高清。
  • low：流畅。
  • lossless：无损。
  • medium：自适应 [默认值]。
low
GpuAccelerationstring否

是否为图形型规格云电脑开启画质策略。对云电脑性能和使用体验要求较高时，例如专业设计场景下，建议开启该策略。

枚举值：
  • off：关闭。
  • on：开启。
off
Html5FileTransferstring否

Web 客户端文件传输策略。

枚举值：
  • all：允许上传下载。
  • download：允许下载。
  • upload：允许上传。
  • off：关闭 [默认值]。
off
Watermarkstring否

水印。

枚举值：
  • blind：开启盲水印。
  • off：关闭水印 [默认值]。
  • on：开启明水印。
off
Namestring是

策略名称。

testPolicyGroupName
WatermarkTypestring否

水印类型。最多可以选择 3 个类型，用半角逗号隔开。

说明 若传入custom，则必须同时通过参数WatermarkCustomText传入自定义文本的内容。
枚举值：
  • EndUserId：用户名。
  • Custom：自定义文本。
  • DesktopIp：云电脑IP地址。
  • ClientIp：客户端IP地址。
  • HostName：云电脑ID的后15位。
  • ClientTime：云电脑当前时间。
EndUserId,HostName,ClientTime
WatermarkCustomTextstring否

若参数WatermarkType传入custom，则必须同时通过参数WatermarkCustomText传入自定义文本的内容。

test
WatermarkTransparencyValueinteger否

水印不透明度，值越大，透明度越小。 取值范围： 10~100。

10
WatermarkSecuritystring否

盲水印安全优先规则。

枚举值：
  • off：关闭。
  • on：开启。
on
CameraRedirectstring否

本地摄像头重定向。当 DeviceRedirects 中没有本地摄像头重定向策略时生效。

枚举值：
  • deviceRedirect：设备重定向。
  • off：关闭。
off
NetRedirectstring否

是否开启网络重定向。

说明 该功能处于定向邀测中，暂不对外开放。
枚举值：
  • all：开启全局模式。
  • off：关闭 [默认值]。
  • on：开启白名单模式。
off
AppContentProtectionstring否

是否开启防截屏功能。

枚举值：
  • off：关闭 [默认值]。
  • on：开启。
off
RemoteCoordinatestring否

远程协助时的键鼠控制权限。

枚举值：
  • optionalControl：默认关闭（可以申请打开）。
  • fullControl：完全控制。
  • disableControl：不控制。
fullControl
InternetCommunicationProtocolstring否

网络通信协议。

枚举值：
  • tcp：TCP模式适用于UDP/AST被限制场景。
  • rtc：AST模式适用于音视频高频使用场景。
  • auto：AUTO模式将依据桌面内容自动在AST和UDP模式间切换。
  • both：UDP模式适用于办公和高清图形设计场景。
both
VideoRedirectstring否

多媒体重定向。

枚举值：
  • off：关闭媒体重定向。
  • on：打开媒体重定向。
on
WatermarkColorinteger否

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

0
WatermarkDegreedouble否

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

-10
WatermarkFontSizeinteger否

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

10
WatermarkFontStylestring否

水印字体样式。

枚举值：
  • plain：普通。
  • bold：加粗。
plain
WatermarkRowAmountinteger否

水印行数。取值范围：3~10。

3
WatermarkColumnAmountinteger否

水印列数。取值范围：3~10。

3
CpuProtectedModestring否

CPU 保护模式开关。

枚举值：
  • off：关闭。
  • on：开启。
off
CpuRateLimitinteger否

CPU 整体使用率百分比，取值范围： 70~90。

70
CpuSampleDurationinteger否

CPU 整体采样时长，取值范围： 10~60。单位：秒。

60
CpuSingleRateLimitinteger否

CPU 单核使用率百分比，取值范围： 70~100。

70
CpuDownGradeDurationinteger否

CPU 降频时长，取值范围： 30~120。单位：秒。

30
MemoryProtectedModestring否

内存保护模式开关。

枚举值：
  • off：关闭。
  • on：开启。
off
MemoryRateLimitinteger否

内存整体使用率百分比，取值范围： 70~90。

70
MemorySampleDurationinteger否

内存整体采样时长，取值范围： 30~60。单位：秒。

40
MemorySingleRateLimitinteger否

单个进程内存使用率百分比，取值范围： 30~60。

40
MemoryDownGradeDurationinteger否

单个进程内存降频时长，取值范围： 30~120。单位：秒。

40
EndUserApplyAdminCoordinatestring否

用户请求管理员协助。

枚举值：
  • off：关闭。
  • on：开启。
off
EndUserGroupCoordinatestring否

同一个办公网络下用户共享云电脑。

枚举值：
  • off：关闭。
  • on：开启。
off
Scopestring否

策略的生效范围。

枚举值：
  • IP：指定IP生效。
  • GLOBAL：全局生效。
GLOBAL
Recordingstring否

是否开启录屏。

枚举值：
  • period：间隔录屏。
  • session：会话录屏。
  • off：关闭。
  • alltime：全程录屏。
off
RecordingAudiostring否

录制云电脑声音的选项。

枚举值：
  • off：录制画面。
  • on：录制系统及外设声音。
on
RecordingStartTimestring否

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

08:00:00
RecordingEndTimestring否

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

08:59:00
RecordingFpsstring否

录屏帧率。单位：FPS（帧/秒）。

2
RecordingDurationinteger否

录屏文件阅览时长，单位为分钟。录制文件会根据您设置的时长自动切分并上传至存储空间，文件达到 300MB 时优先滚动更新。取值范围：10～60。

10
RecordingExpiresinteger否

录屏文件的保留时间。取值范围为 1~180 天。

15
RecordingUserNotifystring否

提示终端客户已开启录屏。

枚举值：
  • off：不提示客户开启录屏。
  • on：提示客户会开启录屏。
off
RecordingUserNotifyMessagestring否

提示终端客户开启录屏的信息。

录屏已开启
AdminAccessstring否

用户登录云电脑后是否具有管理员权限。

说明 该功能处于定向邀测中，暂不对外开放。
枚举值：
  • allow：强制允许。
  • deny：强制拒绝。
  • inherited：继承用户维度的管理员权限控制。
deny
EnableSessionRateLimitingstring否

会话带宽限速。

枚举值：
  • off：关闭。
  • on：开启。
off
SessionMaxRateKbpsinteger否

会话带宽限速最大值。单位：Kbps。取值范围：2000～100000。

2000
DisplayModestring否

显示模式。

枚举值：
  • clientCustom：用户自主配置。
  • adminOffice：日常办公场景。
  • adminDesign：设计及3D应用。
  • adminCustom：自定义。
clientCustom
StreamingModestring否

流模式适配场景。

枚举值：
  • intelligent：智能模式。
  • smooth：流畅优先。
smooth
ColorEnhancementstring否

设计及 3D 应用场景选择是否开启色彩增强。

枚举值：
  • off：关闭。
  • on：开启。
off
SmoothEnhancementstring否

日常办公场景选择，是否开启平滑度增强。

枚举值：
  • off：关闭。
  • on：开启。
off
QualityEnhancementstring否

设计及 3D 应用场景选择是否开启画质增强。

枚举值：
  • off：关闭。
  • on：开启。
off
VideoEncPolicystring否

视频编码策略。

枚举值：
  • qualityFirst：质量优先。
  • bandwidthFirst：带宽优先。
qualityFirst
TargetFpsinteger否

目标帧率，取值范围：10~60。

30
VideoEncMinQPinteger否

视频编码最小 QP，最高质量。取值范围：0~51。

30
VideoEncMaxQPinteger否

视频编码最大 QP，画面最低质量，取值范围：0~51。

30
VideoEncAvgKbpsinteger否

视频编码平均码率。单位：Kbps。取值范围：1000~50000。

2000
VideoEncPeakKbpsinteger否

视频编码峰值码率。单位：Kbps。取值范围：1000~50000。

2000
MaxReconnectTimeinteger否

云电脑由于客观原因造成断开连接的最大连接重试时间。取值范围：30~7200，单位：秒。

120
WyAssistantstring否

通过桌面端（包括 Windows 客户端和 macOS 客户端）连接云电脑时，是否在云电脑悬浮球内提供无影 AI 助手功能入口。

说明 仅适用于 V7.7 或更高版本的桌面端。
枚举值：
  • off：关闭。
  • on：打开。
on
CpuProcessorsarray否

进程名。

string否

进程名。

notepad.exe
MemoryProcessorsarray否

进程名。

string否

进程名。

chrome.exe
DomainResolveRulearray<object>否

域名解析策略。

object否

域名解析策略详情。

Domainstring否

域名。

*.example.com
Policystring否

解析策略。

枚举值：
  • allow：允许。
  • block：拒绝。
allow
Descriptionstring否

策略描述。

测试规则
NetRedirectRulearray<object>否

网络重定向策略详情。

说明 该功能处于定向邀测中，暂不对外开放。
object否

网络重定向策略详情。

说明 该功能处于定向邀测中，暂不对外开放。
Domainstring否

域名。

*.example.com
RuleTypestring否

规则类型。

枚举值：
  • prc：进程。
  • domain：域名。
domain
Policystring否

重定向策略。

allow
ScopeValuearray否

Scope取值为IP的时候填写。当Scope为IP时生效，否则不生效。

string否

生效的 CIDR Block 范围。

47.100.XX.XX/24
ClientTypearray<object>否

登录方式管控规则列表。用于控制可通过哪些客户端访问云电脑。

object否

登录方式管控规则。

Statusstring否

登录方式管控，设置是否允许使用某一类型的客户端登录云电脑。

说明 如果不设置ClientType相关参数，则默认允许所有类型的客户端登录云电脑。
枚举值：
  • off：不允许。
  • on：允许。
off
ClientTypestring否

登录方式管控，设置客户端类型。

枚举值：
  • html5：Web客户端。
  • android：Android客户端。
  • ios：iOS客户端。
  • windows：Windows客户端。
  • macos：macOS客户端。
windows
UsbSupplyRedirectRulearray<object>否

USB 重定向规则。

object否

USB 重定向规则。

VendorIdstring否

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

04**
UsbRuleTypestring否

USB 重定向规则类型。

枚举值：
  • 2：产品。
2
Descriptionstring否

规则描述。

测试规则
UsbRedirectTypestring否

USB 重定向类型。

枚举值：
  • 1：允许。
  • 2：拒绝。
1
ProductIdstring否

产品 ID。

08**
AuthorizeSecurityPolicyRulearray<object>否

安全组管控规则列表。

object否

安全组管控规则列表。

Typestring否

安全组管控规则的规则方向。

枚举值：
  • outflow：出方向。
  • inflow：入方向。
inflow
Policystring否

安全组管控规则的授权策略。

枚举值：
  • 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协议。
  • ALL：支持所有协议。
  • GRE：GRE协议。
  • ICMP：ICMP（IPv4）协议。
TCP
Prioritystring否

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

1
CidrIpstring否

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

10.0.XX.XX/8
AuthorizeAccessPolicyRulearray<object>否

客户端 IP 白名单列表。设置后，仅白名单网段内的 IP 地址可访问云电脑。

object否

客户端 IP 白名单列表。

Descriptionstring否

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

test
CidrIpstring否

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

47.100.XX.XX/16
DeviceRedirectsarray<object>否

设备重定向规则列表。

object否

设备重定向规则列表。

RedirectTypestring否

重定向类型。

枚举值：
  • deviceRedirect：设备重定向。
  • usbRedirect：usb重定向。
  • off：关闭。
usbRedirect
DeviceTypestring否

设备类型

枚举值：
  • printer：打印机。
  • scanner：扫描仪。
  • serialport：串口设备。
  • camera：摄像头。
  • adb：adb。
camera
DeviceRulesarray<object>否

自定义外设规则列表。

object否

自定义外设规则列表。

DeviceNamestring否

设备名称。

sandisk
RedirectTypestring否

重定向类型。

枚举值：
  • deviceRedirect：设备重定向。
  • usbRedirect：USB重定向。
  • off：禁止。
usbRedirect
DeviceTypestring否

外设类型。

枚举值：
  • usbKey：UKey。
  • other：其他。
  • graphicsTablet：手绘板。
  • cardReader：读卡器。
  • printer：打印机。
  • scanner：扫描仪。
  • storage：存储设备。
  • camera：摄像头。
  • networkInterfaceCard：网卡设备。
storage
OptCommandstring否

链接优化指令。

2:0
DevicePidstring否

产品 ID。

0x55b1
DeviceVidstring否

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

0x0781
WatermarkAntiCamstring否

盲水印防拍照功能。

枚举值：
  • off：关闭。
  • on：开启。
off
WatermarkPowerstring否

盲水印增强功能。

枚举值：
  • high：高。
  • low：低。
  • medium：中。
medium
DomainResolveRuleTypestring否

域名解析策略类型。

枚举值：
  • off：关闭。
  • on：开启。
off
ClipboardScopestring否

剪切板生效范围

GLOBAL
ClipboardGrainedsarray<object>否

剪切板精细化控制配置

StatusMonitorstring否

是否在云电脑悬浮球内提供状态监控功能入口。

枚举值：
  • off：关闭。
  • on：开启。
off
MobileRestartstring否

通过移动端（Android 客户端和 iOS 客户端）连接云电脑时，是否在云电脑悬浮球内提供重启按钮。

说明 仅适用于 V7.4 或更高版本的移动端。
枚举值：
  • off：关闭。
  • on：开启。
off
MobileShutdownstring否

通过移动端（Android 客户端和 iOS 客户端），是否在云电脑悬浮球内提供关机按钮。

说明 仅适用于 V7.4 或更高版本的移动端。
枚举值：
  • off：关闭。
  • on：开启。
off
ResolutionModelstring否

分辨率类型。

枚举值：
  • adaptive：自适应分辨率。
  • customer：固定分辨率。
adaptive
ResolutionWidthinteger否

分辨率的宽度。单位：像素。云应用取值范围：500~50000， 云电脑取值范围：640~4096。

720
ResolutionHeightinteger否

分辨率的高度。单位：像素。云应用取值范围：500~50000， 云电脑取值范围：480~4096。

1280
Taskbarstring否

应用任务栏。

说明 仅适用于云应用策略。
枚举值：
  • off：关闭。
  • on：开启。
off
NoOperationDisconnectstring否

无操作断连。

说明 仅适用于云应用策略。
枚举值：
  • off：关闭。
  • on：开启。
off
NoOperationDisconnectTimeinteger否

无操作断连时长。取值范围：120~7200。单位：秒。

说明 仅适用于云应用策略。
120
DisconnectKeepSessionstring否

会话断连保留。

说明 仅适用于云应用策略。
枚举值：
  • customTime：固定时间。
  • persistent：不断连。
customTime
DisconnectKeepSessionTimeinteger否

会话断连保留时长。取值范围：30~7200。单位：秒。

说明 仅适用于云应用策略。
30
RecordEventsarray否

录屏事件列表。

string否

录屏事件。

枚举值：
  • transferWithLocal：剪贴板及文件传输操作。
  • userInput：用户输入。
  • usbRedirect：USB外设插拔。
transferWithLocal
RecordEventFilePathsarray否

录屏审计中的文件监控绝对路径。

string否

录屏审计中的文件监控绝对路径。

C://test.txt
RecordEventRegistersarray否

录屏审计中的注册表监控绝对路径。

string否

录屏审计中的注册表监控绝对路径。

计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\USBSTOR
RecordEventDurationinteger否

录屏审计中检测到事件发生后录屏的时长。单位：分钟。取值范围：10~60。

10
ResetDesktopstring否

重置云电脑。

off
DeviceConnectHintstring否

外设连接提示控制。

off
FileMigratestring否

文件迁移。

off
WuyingKeeperstring否

无影管家开关。

off
AutoReconnectstring否

客户端自动重连开关

off
MobileWuyingKeeperstring否

移动端无影管家开关

off
MobileSafeMenustring否

移动端 Windows 安全控制开关

off
MobileWyAssistantstring否

移动端小颖的开关

off
RecordEventLevelsarray<object>否

录屏事件的级别

object否
EventTypestring否

事件类型

StartApplication
EventLevelstring否

事件等级

HIGH
RecordEventFileExtsarray否

录屏事件文件扩展名

string否
txt

返回参数

名称类型描述示例值
object
PolicyGroupIdstring

云电脑策略 ID。

pg-gx2x1dhsmthe9****
RequestIdstring

请求 ID。

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

示例

正常返回示例

JSON格式

{
  "PolicyGroupId": "pg-gx2x1dhsmthe9****",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

错误码

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

变更历史

变更时间变更内容概要操作
2025-10-27OpenAPI 入参发生变更查看变更详情
上一篇：DescribeCenterPolicyList - 查询无地域策略下一篇：CloneCenterPolicy - 克隆无地域策略