接口说明
开放政企版查看电脑策略详情接口 限流:根据租户实现用户级别的限流,限制为100次每秒
URL
GET https://ecloud.10086.cn/api/clouddesktopnew/cem_openapi/ccacem/api/v1/computerPolicy/getPolicyInfoById
请求参数
Query
|
参数名称
|
类型
|
必填
|
描述
|
|
policyId
|
string
|
是
|
电脑策略id |
请求示例
GET https://ecloud.10086.cn/api/clouddesktopnew/cem_openapi/ccacem/api/v1/computerPolicy/getPolicyInfoById
返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
CemComputerPolicyListResp
|
请求成功时返回的数据 |
|
audioPlayBackMode
|
string
|
音频播放模式 |
|
autoDesktopQuality
|
integer(int32)
|
画质 |
|
bandwidthLimitEnable
|
string
|
带宽是否启用 |
|
bindMachineCount
|
integer(int32)
|
关联电脑数 |
|
clipboardBandwidth
|
integer(int32)
|
剪贴板带宽 |
|
companyName
|
string
|
厂商名称 |
|
createdTime
|
string
|
创建时间 |
|
customWallpaperAbsolutePath
|
string
|
自定义壁纸绝对路径 |
|
customWallpaperEnable
|
string
|
自定义壁纸是否启用 |
|
dc
|
string
|
网络工作区 |
|
desktopStreamRat
|
integer(int32)
|
桌面流帧率 |
|
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)
|
桌面工具栏枚举值 |
|
value
|
string
|
桌面工具栏value |
|
diskBandwidth
|
integer(int32)
|
磁盘带宽 |
|
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
|
备注 |
|
fixedDrive
|
string
|
固定驱动器(即本地系统除系统盘外其他磁盘)禁用(disable)、启用(enable) |
|
modifiedTime
|
string
|
修改时间 |
|
netRedirectEnable
|
string
|
网络重定向开关 |
|
netRedirectMode
|
string
|
重定向模式, 白名单模式:whitelistMode 全局模式:globalMode |
|
netRedirectWhitelistInfoDtos
|
<ExdNetRedirectWhitelistInfoDto> array
|
白名单规则 |
|
policyId
|
string
|
策略ID (非标准uuid) |
|
whitelistRule
|
string
|
白名单规则 |
|
whitelistType
|
string
|
白名单类型(域名:domainName 进程:process) |
|
networkDrive
|
string
|
网络驱动器 禁用(disable)、启用(enable) |
|
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)
|
桌面工具栏枚举值 |
|
value
|
string
|
桌面工具栏value |
|
networkScannerEnable
|
string
|
是否开启网络扫描仪,关闭(disable)、开启(enable), 默认关闭 5.3.0_PT新增 |
|
opticalDiscDrive
|
string
|
光盘驱动器 禁用(disable)、启用(enable) |
|
policyId
|
string
|
策略id |
|
policyName
|
string
|
策略名称 |
|
policyRemark
|
string
|
策略描述 |
|
policyStatus
|
string
|
策略状态 |
|
poolCode
|
string
|
资源池编码 |
|
poolName
|
string
|
资源池名称 |
|
qosInfoDetail
|
QosInfoRespDto
|
qos信息 |
|
bandwidthType
|
string
|
带宽类型,当前仅上下行带宽 |
|
description
|
string
|
描述 |
|
qosName
|
string
|
qos名称 |
|
qosSize
|
integer(int32)
|
带宽数值 |
|
qosUid
|
string
|
qosUid |
|
redirectCamera
|
string
|
摄像头 关闭(disable)、可用(enable) |
|
redirectClipboard
|
string
|
重定向剪贴板 |
|
redirectCustom
|
string
|
自定义usb重定向, 禁用(disable)、可用(enable) |
|
redirectCustomDetail
|
<CemExdPolicyDto> array
|
桌面绑定外设策略状态 |
|
classFilter
|
string
|
扫描仪(scanner),打印机(printer),存储设备(storage),摄像头(camera),智能卡(smartCard),无线设备(wireless),其他设备(other),全部(all) |
|
pidFilter
|
string
|
pid |
|
vidFilter
|
string
|
vid |
|
action
|
string
|
黑白名单:白名单(enable), 黑名单(disable) |
|
extRemark
|
string
|
备注 |
|
redirectLocalDisk
|
string
|
重定向本地磁盘 禁用(disable)、只读(ro)、读写(rw) |
|
redirectUsbStorage
|
string
|
重定向USB存储,禁用(disable),读写(enable),只读(ro) |
|
region
|
string
|
可用区 |
|
regionName
|
string
|
可用区名称 |
|
removableDrive
|
string
|
可移动驱动器 禁用(disable)、启用(enable) |
|
responseMsg
|
string
|
失败原因 |
|
scannerEnable
|
string
|
是否开启USB扫描仪,禁用(disable)、可用(enable) |
|
screenDetail
|
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天 |
|
screenShotEnable
|
string
|
防止截屏 禁用(disable)、可用(enable) |
|
securityGroupDetail
|
ExdAndSgRefInfoDto
|
安全组相关信息 |
|
companyCode
|
string
|
厂商编码 |
|
description
|
string
|
描述 |
|
haveBindingMachine
|
string
|
是否含有绑定中机器,含有则无法动态删减. true: 安全组含有绑定中机器, false: 安全组不含有绑定中机器 |
|
poolCode
|
string
|
资源池编码 |
|
region
|
string
|
可用区 |
|
securityGroupName
|
string
|
安全组名称 |
|
securityGroupUid
|
string
|
安全组Uid |
|
stateType
|
string
|
状态类型(有状态和无状态) |
|
status
|
string
|
安全组状态,creating创建中,create创建完成待生效,effective已生效,createError创建失败 |
|
securityGroupDetails
|
<ExdAndSgRefInfoDto> array
|
安全组相关信息列表 |
|
companyCode
|
string
|
厂商编码 |
|
description
|
string
|
描述 |
|
haveBindingMachine
|
string
|
是否含有绑定中机器,含有则无法动态删减. true: 安全组含有绑定中机器, false: 安全组不含有绑定中机器 |
|
poolCode
|
string
|
资源池编码 |
|
region
|
string
|
可用区 |
|
securityGroupName
|
string
|
安全组名称 |
|
securityGroupUid
|
string
|
安全组Uid |
|
stateType
|
string
|
状态类型(有状态和无状态) |
|
status
|
string
|
安全组状态,creating创建中,create创建完成待生效,effective已生效,createError创建失败 |
|
streamingVideo
|
integer(int32)
|
图流设置 |
|
tenantId
|
string
|
|
|
tenantName
|
string
|
|
|
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)
|
桌面工具栏枚举值 |
|
value
|
string
|
桌面工具栏value |
|
terminalSystemDisk
|
string
|
终端系统磁盘(即本地系统盘,通常指C盘) :禁用(disable)、启用(enable) |
|
usbBandwidth
|
integer(int32)
|
usb带宽 |
|
watermarkAngle
|
integer(int32)
|
水印倾斜度 |
|
watermarkColor
|
string
|
水印字体颜色 |
|
watermarkCustomField
|
string
|
自定义字段 |
|
watermarkCustomFieldEnable
|
string
|
是否显示自定义字段 禁用(disable)、开启(enable) |
|
watermarkEnable
|
string
|
是否开启水印 禁用(disable)、开启(enable) |
|
watermarkFont
|
string
|
字体, 幼圆:YouYuan, 宋体:SimSun, 楷体:KaiTi |
|
watermarkMachineIdEnable
|
string
|
是否显示云电脑ID 禁用(disable)、开启(enable) |
|
watermarkMachineIpEnable
|
string
|
是否显示云电脑IP 禁用(disable)、开启(enable) |
|
watermarkMachineMacEnable
|
string
|
是否显示云电脑mac 禁用(disable)、开启(enable) |
|
watermarkSize
|
integer(int32)
|
水印字体大小,单位px |
|
watermarkTimeEnable
|
string
|
是否显示时间 禁用(disable)、开启(enable) |
|
watermarkTransparency
|
integer(int32)
|
水印透明度 |
|
watermarkType
|
string
|
水印类型,明水印(0)、盲水印(1) |
|
printerEnable
|
string
|
是否开启打印机,禁用(disable)、可用(enable) |
|
networkPrinterEnable
|
string
|
是否开启网络打印机,禁用(disable)、可用(enable) |
|
redirectSerialport
|
string
|
串口 关闭(disable)、可用(enable) 默认 enable |
|
redirectParallelport
|
string
|
并口 关闭(disable)、可用(enable) 默认 enable |
|
autoLock
|
string
|
自动锁屏,单位分钟 默认锁屏时间 0 不锁屏 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
错误码提示信息 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,FORBIDDEN,REMAINING,TIMEOUT)
|
返回状态码;返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN |
返回示例
{
"state":"OK",
"body":{
"policyId":"23a45b14-c7b9-4305-a157-85d918d24f24",
"policyName":"openapi测试8",
"policyRemark":null,
"policyStatus":"alter",
"redirectCustom":"disable",
"redirectClipboard":"both",
"redirectLocalDisk":"rw",
"fixedDrive":"disable",
"removableDrive":null,
"opticalDiscDrive":null,
"networkDrive":null,
"terminalSystemDisk":null,
"redirectUsbStorage":"enable",
"exdPolicyExts":null,
"redirectCamera":"enable",
"scannerEnable":"enable",
"networkScannerEnable":"disable",
"printerEnable":"enable",
"networkPrinterEnable":"enable",
"redirectSerialport":"enable",
"redirectParallelport":"enable",
"createdTime":"2025-09-21 15:44:35",
"modifiedTime":"2025-09-21 16:27:17",
"companyName":"移动云",
"poolCode":"CIDC-RP-25",
"poolName":"华东-苏州",
"dc":null,
"region":"CIDC-RP-25-AZ2",
"regionName":"可用区二",
"tenantId":"1720405295939649537",
"tenantName":"csy_csb_saas_wusai_ext_02",
"redirectCustomDetail":[],
"bindMachineCount":0,
"screenShotEnable":"enable",
"watermarkType":"0",
"watermarkEnable":"enable",
"watermarkMachineIdEnable":"enable",
"watermarkMachineIpEnable":"enable",
"watermarkMachineMacEnable":"disable",
"watermarkTimeEnable":"disable",
"watermarkCustomFieldEnable":"disable",
"watermarkCustomField":null,
"watermarkSize":12,
"watermarkColor":"#000000",
"watermarkTransparency":50,
"watermarkAngle":0,
"watermarkFont":"SimSun",
"customWallpaperEnable":"disable",
"customWallpaperAbsolutePath":null,
"screenDetail":{
"screenAuditPolicyUid":"967557b8-c0a0-4a7d-b51f-9c864204e7db",
"screenRecordEnable":"disable",
"screenType":null,
"intervalRecordStartTime":null,
"intervalRecordEndTime":null,
"screenTriggerMode":null,
"screenRecordMode":"1",
"screenFPS":"5",
"screenDuration":"10",
"auditRetention":"15"
},
"responseMsg":null,
"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"
}
],
"desktopStreamRat":30,
"autoDesktopQuality":2,
"streamingVideo":2,
"bandwidthLimitEnable":"disable",
"usbBandwidth":500,
"diskBandwidth":500,
"clipboardBandwidth":500,
"audioPlayBackMode":"3",
"autoLock":"0",
"securityGroupDetail":{
"securityGroupUid":"sg-a551ec2f9c3a4c5db970aaa05c4f47d4",
"securityGroupName":"ceshisecurity1_3",
"description":"",
"stateType":"stateful",
"companyCode":"CMSSZTE",
"poolCode":"CIDC-RP-25",
"region":"CIDC-RP-25-AZ2",
"status":"active",
"haveBindingMachine":"false"
},
"securityGroupDetails":[
{
"securityGroupUid":"sg-a551ec2f9c3a4c5db970aaa05c4f47d4",
"securityGroupName":"ceshisecurity1_3",
"description":"",
"stateType":"stateful",
"companyCode":"CMSSZTE",
"poolCode":"CIDC-RP-25",
"region":"CIDC-RP-25-AZ2",
"status":"active",
"haveBindingMachine":"false"
}
],
"qosInfoDetail":null,
"netRedirectEnable":"enable",
"netRedirectMode":"whitelistMode",
"netRedirectWhitelistInfoDtos":[]
},
"errorCode":"200",
"errorMessage":"",
"requestId":"ea3aac4ccbdf6f8d"
}