接口说明
开放政企版创建电脑策略V2接口 - 返回值带策略ID 限流:根据租户实现用户级别的限流,限制为100次每秒
URL
POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/computerPolicy/createPolicyV2
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
reqDto
|
CreateComputerPolicyReqDto
|
是
|
reqDto |
|
policyName
|
string
|
是
|
策略名称 |
|
policyRemark
|
string
|
否
|
策略描述 |
|
dc
|
string
|
否
|
网络工作区,V2.0协议非必传 |
|
poolCode
|
string
|
是
|
所属资源池 |
|
region
|
string
|
是
|
所属可用区 |
|
computerProtocol
|
string
|
是
|
电脑协议(V2.0:自研CMSSZTE,V1.1:新华三,V1.2:中兴) |
|
redirectLocalDiskScope
|
CemRedirectLocalDiskScope
|
否
|
本地磁盘映射作用范围 |
|
fixedDrive
|
string
|
否
|
固定驱动器(即本地系统除系统盘外其他磁盘)取值:禁用(disable)、启用(enable) |
|
networkDrive
|
string
|
否
|
网络驱动器 取值:禁用(disable)、启用(enable) |
|
opticalDiscDrive
|
string
|
否
|
光盘驱动器 取值:禁用(disable)、启用(enable) |
|
redirectLocalDisk
|
string
|
否
|
重定向本地磁盘 默认读写, 禁用(disable)、只读(ro)、读写(rw) |
|
removableDrive
|
string
|
否
|
可移动驱动器 取值:禁用(disable)、启用(enable) |
|
terminalSystemDisk
|
string
|
否
|
终端系统磁盘(即本地系统盘,通常指C盘) 取值:禁用(disable)、启用(enable) |
|
redirectClipboard
|
string
|
否
|
重定向剪贴板,禁用(disable)、云端到本地(c2l), 本地到云端(l2c), 双向(both),默认both |
|
redirectUsbStorage
|
string
|
否
|
重定向USB存储,禁用(disable),读写(enable),只读(ro),默认enable |
|
redirectCamera
|
string
|
否
|
摄像头 关闭(disable)、可用(enable) 默认enable |
|
scannerEnable
|
string
|
否
|
是否开启USB扫描仪,禁用(disable)、可用(enable) |
|
networkScannerEnable
|
string
|
否
|
是否开启网络扫描仪,关闭(disable)、开启(enable), 默认关闭 |
|
printerEnable
|
string
|
否
|
是否开启打印机,禁用(disable)、可用(enable) |
|
networkPrinterEnable
|
string
|
否
|
是否开启网络打印机,禁用(disable)、可用(enable) |
|
redirectSerialport
|
string
|
否
|
串口 关闭(disable)、可用(enable) 默认 enable |
|
redirectParallelport
|
string
|
否
|
并口 关闭(disable)、可用(enable) 默认 enable |
|
redirectCustom
|
string
|
否
|
自定义USB重定向策略配置 关闭(disable)、可用(enable) 默认 disable |
|
exdPolicyExts
|
<CemExdPolicyDto> array
|
否
|
自定义USB重定向策略详情列表 |
|
classFilter
|
string
|
否
|
扫描仪(scanner),打印机(printer),存储设备(storage),摄像头(camera),智能卡(smartCard),无线设备(wireless),其他设备(other),全部(all) |
|
pidFilter
|
string
|
否
|
pid |
|
vidFilter
|
string
|
否
|
vid |
|
action
|
string
|
否
|
黑白名单:白名单(enable), 黑名单(disable) |
|
extRemark
|
string
|
否
|
备注 |
|
watermarkClass
|
WatermarkClass
|
否
|
水印详情 |
|
watermarkType
|
string
|
否
|
水印类型,明水印(0)、盲水印(1) 默认 明水印(0) |
|
watermarkEnable
|
string
|
否
|
是否开启水印,关闭(disable)、开启(enable) |
|
watermarkMachineIdEnable
|
string
|
否
|
是否显示云电脑ID |
|
watermarkMachineIpEnable
|
string
|
否
|
是否显示云电脑IP |
|
watermarkMachineMacEnable
|
string
|
否
|
是否显示云电脑mac |
|
watermarkTimeEnable
|
string
|
否
|
是否显示时间 |
|
watermarkCustomFieldEnable
|
string
|
否
|
是否显示自定义字段 |
|
watermarkCustomField
|
string
|
否
|
自定义字段 |
|
watermarkFont
|
string
|
否
|
字体, 幼圆:YouYuan, 宋体:SimSun, 楷体:KaiTi |
|
watermarkSize
|
integer(int32)
|
否
|
水印字体大小,单位px,范围<1-60> |
|
watermarkColor
|
string
|
否
|
水印字体颜色 #RRGGBB ,每个颜色用2个字节标识,范围<#000000-#ffffff> |
|
watermarkTransparency
|
integer(int32)
|
否
|
水印透明度,新华三中兴 (H3C、H3CEcloud)可设置值:50、100,自研和中兴(CMSSZTE、ZTE、ZTEEcloud)可设置值:1~100 0就是透明,100就是不透明 |
|
watermarkAngle
|
integer(int32)
|
否
|
水印倾斜度,枚举0,45 |
|
screenShotEnable
|
string
|
否
|
防截屏 禁用(disable)、可用(enable) 默认 enable |
|
autoLock
|
string
|
否
|
自动锁屏,单位分钟 默认锁屏时间 0 不锁屏 |
|
exdPolicyCustomWallpaperClass
|
CemExdPolicyCustomWallpaperClass
|
否
|
自定义电脑壁纸 |
|
customWallpaperAbsolutePath
|
string
|
否
|
自定义壁纸绝对路径 |
|
customWallpaperEnable
|
string
|
否
|
自定义壁纸开关 开启 enable 关闭 disable,默认 disable |
|
customWallpaperRelativePath
|
string
|
否
|
自定义壁纸相对路径 |
|
exdPolicyScreenRecordeClass
|
CemExdPolicyScreenRecordeClass
|
否
|
录屏管控 |
|
screenAuditPolicyUid
|
string
|
否
|
录屏审计策略表uid |
|
screenRecordEnable
|
string
|
否
|
录屏策略开关 取值 disable 、enable(默认) |
|
screenType
|
string
|
否
|
录屏类型 0:全程录屏 1: 间隔录屏(默认) 2:用户操作录屏 3:监听会话生命周期录屏 |
|
intervalRecordStartTime
|
string
|
否
|
间隔录屏开始时间 |
|
intervalRecordEndTime
|
string
|
否
|
间隔录屏结束时间 |
|
screenTriggerMode
|
string
|
否
|
用户操作录屏方式 1:云电脑与本地电脑进行文件双向上传、下载录屏 2:执行命令录屏 |
|
screenRecordMode
|
string
|
否
|
录制云电脑声音 1:仅录制画面不录制声音(默认) 2:音画同期录制 |
|
screenFPS
|
string
|
否
|
录屏图像帧率:单位fps 图像帧率:2 fps、5 fps(推荐)、10 fps和15 fps |
|
screenDuration
|
string
|
否
|
录屏文件阅览时长:单位分钟, 可选时长:10分钟(默认)、20分钟、30分钟、或60分钟 |
|
auditRetention
|
string
|
否
|
保留时长:单位天, 默认15天 保留时间的范围为:1~180天 |
|
terminalLoginPolicys
|
<DevicePolicyDetailReq> array
|
否
|
终端登录策略 |
|
category
|
enum(CLOSE_MACHINE,BAN_TERMINAL_TYPE,SHUT_SETTING,RESTART_SETTING,RECONNECT_INTERVAL,RECONNECT_TOTAL,CLOSE_DEVICE_SOURCE,DISCONNECT,START_MODE,UPDATE_MACHINE_NAME,ALLOW_RELOAD,BIGSCREEN_NET_CHECK,BIGSCREEN_ATTENTION,BIGSCREEN_SET,BIGSCREEN_MINIMIZE,BIGSCREEN_WINDOWED,BIGSCREEN_QUIT,BIGSCREEN_QUIT_BREAK,BIGSCREEN_QUIT_RESTART,BIGSCREEN_QUIT_SHUT,MOBILE_MANAGE,MOBILE_HELP,MOBILE_QUIT,MOBILE_QUIT_BREAK,MOBILE_QUIT_RESTART,MOBILE_QUIT_SHUT,CONNECT_TYPE,BREAK_SHUT,AUTO_LOCK,AUTO_LOGOUT,TOP_TOOLBAR)
|
否
|
|
|
value
|
string
|
否
|
|
|
desktopToolbarPolicys
|
<DevicePolicyDetailReq> array
|
否
|
桌面工具栏策略 |
|
category
|
enum(CLOSE_MACHINE,BAN_TERMINAL_TYPE,SHUT_SETTING,RESTART_SETTING,RECONNECT_INTERVAL,RECONNECT_TOTAL,CLOSE_DEVICE_SOURCE,DISCONNECT,START_MODE,UPDATE_MACHINE_NAME,ALLOW_RELOAD,BIGSCREEN_NET_CHECK,BIGSCREEN_ATTENTION,BIGSCREEN_SET,BIGSCREEN_MINIMIZE,BIGSCREEN_WINDOWED,BIGSCREEN_QUIT,BIGSCREEN_QUIT_BREAK,BIGSCREEN_QUIT_RESTART,BIGSCREEN_QUIT_SHUT,MOBILE_MANAGE,MOBILE_HELP,MOBILE_QUIT,MOBILE_QUIT_BREAK,MOBILE_QUIT_RESTART,MOBILE_QUIT_SHUT,CONNECT_TYPE,BREAK_SHUT,AUTO_LOCK,AUTO_LOGOUT,TOP_TOOLBAR)
|
否
|
|
|
value
|
string
|
否
|
|
|
networkPolicys
|
<DevicePolicyDetailReq> array
|
否
|
网络控制 |
|
category
|
enum(CLOSE_MACHINE,BAN_TERMINAL_TYPE,SHUT_SETTING,RESTART_SETTING,RECONNECT_INTERVAL,RECONNECT_TOTAL,CLOSE_DEVICE_SOURCE,DISCONNECT,START_MODE,UPDATE_MACHINE_NAME,ALLOW_RELOAD,BIGSCREEN_NET_CHECK,BIGSCREEN_ATTENTION,BIGSCREEN_SET,BIGSCREEN_MINIMIZE,BIGSCREEN_WINDOWED,BIGSCREEN_QUIT,BIGSCREEN_QUIT_BREAK,BIGSCREEN_QUIT_RESTART,BIGSCREEN_QUIT_SHUT,MOBILE_MANAGE,MOBILE_HELP,MOBILE_QUIT,MOBILE_QUIT_BREAK,MOBILE_QUIT_RESTART,MOBILE_QUIT_SHUT,CONNECT_TYPE,BREAK_SHUT,AUTO_LOCK,AUTO_LOGOUT,TOP_TOOLBAR)
|
否
|
|
|
value
|
string
|
否
|
|
|
bandwidthLimitEnable
|
string
|
否
|
带宽是否启用 关闭(disable)、可用(enable) 默认 disable |
|
usbBandwidth
|
integer(int32)
|
否
|
usb带宽范围, 500 - 2000 KB , 默认 500 KB, 增减步长 500, 单位(KB) |
|
diskBandwidth
|
integer(int32)
|
否
|
磁盘映射范围, 500 - 2000 KB , 默认 500 KB, 增减步长 500, 单位(KB) |
|
clipboardBandwidth
|
integer(int32)
|
否
|
文件拷贝带宽控制-剪贴板范围, 500 - 2000 KB , 默认 500 KB, 增减步长 500, 单位(KB) |
|
securityGroupUid
|
string
|
否
|
安全组UID |
|
qosUid
|
string
|
否
|
Qos规则的UID |
|
streamingVideo
|
integer(int32)
|
否
|
图流设置 默认 2 最小值1 最大值2 |
|
desktopStreamRat
|
integer(int32)
|
否
|
图像上限帧率 默认30 最小值12 最大值100 |
|
autoDesktopQuality
|
integer(int32)
|
否
|
图像画质 默认 2 最小值0 最大值3 |
|
audioPlayBackModeEnable
|
string
|
否
|
音频播放模式是否开启, 禁用(disable)、开启(enable) , 默认 关闭 disable |
|
audioPlayBackMode
|
string
|
否
|
音频播放模式, 1:默认模式 2:极速模式/加速模式 3:流畅模式 |
|
exdCloudSideNetRedirectClass
|
ExdCloudSideNetRedirectClass
|
否
|
云侧网络重定向 |
|
netRedirectEnable
|
string
|
否
|
网络重定向开关: 类非空情况下必填 关闭(disable)、开启(enable) |
|
netRedirectMode
|
string
|
否
|
重定向模式: 开关开启状态下必填, 白名单模式:whitelistMode 全局模式:globalMode |
|
whitelistConfigs
|
<WhitelistConfigClass> array
|
否
|
白名单类型: 白名单模式下配置 |
|
whitelistType
|
string
|
否
|
白名单类型: 白名单模式下必填, 域名:domainName 进程:process |
|
whitelistRule
|
string
|
否
|
白名单规则: 白名单模式下必填 |
请求示例
POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/computerPolicy/createPolicyV2
{
"policyName":"openapi测试",
"computerProtocol":"V2.0",
"poolCode":"CIDC-RP-25",
"region":"CIDC-RP-25-AZ2",
"dc":"",
"redirectClipboard":"both",
"redirectLocalDiskScope":{
"redirectLocalDisk":"rw"
},
"screenShotEnable":"enable",
"watermarkClass":{
"watermarkEnable":"enable",
"watermarkType":"0",
"watermarkMachineIdEnable":"enable",
"watermarkMachineIpEnable":"enable",
"watermarkMachineMacEnable":"disable",
"watermarkTimeEnable":"disable",
"watermarkCustomFieldEnable":"disable",
"watermarkSize":12,
"watermarkColor":"#000000",
"watermarkTransparency":50,
"watermarkAngle":0,
"watermarkFont":"SimSun"
},
"autoLock":"0",
"exdPolicyCustomWallpaperClass":{
"customWallpaperEnable":"disable"
},
"redirectUsbStorage":"enable",
"redirectCamera":"enable",
"networkScannerEnable":"disable",
"redirectSerialport":"enable",
"redirectParallelport":"enable",
"redirectCustom":"enable",
"exdPolicyExts":[
{
"classFilter":"all",
"vidFilter":"1234",
"pidFilter":"4563",
"extRemark":"",
"action":"enable"
}
],
"terminalLoginPolicys":[
{
"category":"RECONNECT_INTERVAL",
"value":5
},
{
"category":"RECONNECT_TOTAL",
"value":30
},
{
"category":"CLOSE_DEVICE_SOURCE",
"value":"0"
},
{
"category":"DISCONNECT",
"value":"0"
},
{
"category":"START_MODE",
"value":"{\"type\":\"0\",\"mode\":\"\",\"macwhite\":\"\"}"
},
{
"category":"UPDATE_MACHINE_NAME",
"value":"0"
},
{
"category":"ALLOW_RELOAD",
"value":"0"
},
{
"category":"BAN_TERMINAL_TYPE",
"value":"PC-WINDOWS,ANDROID-CE,PC-MAC"
},
{
"category":"SHUT_SETTING",
"value":"0"
},
{
"category":"RESTART_SETTING",
"value":"0"
}
],
"desktopToolbarPolicys":[
{
"category":"BIGSCREEN_NET_CHECK",
"value":"0"
},
{
"category":"BIGSCREEN_ATTENTION",
"value":"0"
},
{
"category":"BIGSCREEN_SET",
"value":"0"
},
{
"category":"BIGSCREEN_MINIMIZE",
"value":"0"
},
{
"category":"BIGSCREEN_WINDOWED",
"value":"0"
},
{
"category":"BIGSCREEN_QUIT",
"value":"0"
},
{
"category":"BIGSCREEN_QUIT_BREAK",
"value":"0"
},
{
"category":"BIGSCREEN_QUIT_RESTART",
"value":"0"
},
{
"category":"BIGSCREEN_QUIT_SHUT",
"value":"0"
},
{
"category":"MOBILE_MANAGE",
"value":"0"
},
{
"category":"MOBILE_HELP",
"value":"0"
},
{
"category":"MOBILE_QUIT",
"value":"0"
},
{
"category":"MOBILE_QUIT_BREAK",
"value":"0"
},
{
"category":"MOBILE_QUIT_RESTART",
"value":"0"
},
{
"category":"MOBILE_QUIT_SHUT",
"value":"0"
}
],
"networkPolicys":[
{
"category":"CONNECT_TYPE",
"value":"0"
}
],
"securityGroupUid":"sg-a551ec2f9c3a4c5db970aaa05c4f47d4",
"bandwidthLimitEnable":"enable",
"usbBandwidth":7000,
"diskBandwidth":9000,
"clipboardBandwidth":8000,
"streamingVideo":2,
"desktopStreamRat":30,
"autoDesktopQuality":2,
"audioPlayBackModeEnable":"enable",
"audioPlayBackMode":"2",
"exdCloudSideNetRedirectClass":{
"netRedirectEnable":"enable",
"netRedirectMode":"whitelistMode",
"whitelistConfigs":[
{
"whitelistType":"domainName",
"whitelistRule":"cmss.example.com"
}
]
}
}
返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
ExdPolicyAddRespDto
|
|
|
policyBaseId
|
string
|
策略主键Id |
|
policyId
|
string
|
策略ID (非标准uuid) |
|
errorCode
|
string
|
|
|
errorMessage
|
string
|
|
|
requestId
|
string
|
|
|
state
|
enum(OK,ERROR,EXCEPTION,FORBIDDEN,REMAINING,TIMEOUT)
|
返回示例
{
"body":{
"policyBaseId":"1506594325138505728",
"policyId":"cf628673-d832-4ab4-8b3f-e8d79e3f296d"
},
"errorCode":"200",
"errorMessage":"",
"requestId":"f42f86323424afef",
"state":"OK"
}