查看电脑策略详情

接口说明

开放政企版查看电脑策略详情接口 限流:根据租户实现用户级别的限流,限制为100次每秒


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

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

返回参数

返回码:200
OK
参数名称
类型
描述
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

返回示例

返回码:200
OK
{
	"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"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。