查询终端运行模式策略v3
更新时间 2026-11-09 15:04:02
最近更新时间: 2026-11-09 15:04:02
接口功能介绍
查询终端运行模式优先级、锁定模式以及终端型号和MAC地址白名单。
接口约束
无
URI
GET /v3/strategy/terminalRunMode/describe
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | |
| strategyOid | 是 | String | 策略Oid。 | dsy-xxxxxx |
请求参数
请求头header参数 无
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码，800表示请求成功，900表示请求失败。 | 800 | |
| error | String | 错误码。 | ECPC_1000 | |
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 终端运行模式策略详情。 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| strategyOid | String | 策略Oid。 | ||
| runMode | Object | 终端运行模式配置。 | runMode |
表 runMode
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| priority | String | 运行模式优先级。取值： - CLIENT：客户端设置优先。 - STRATEGY：策略设置优先。 | ||
| mode | String | 运行模式。取值： - NORMAL：常规模式。 - LOCKED：锁定模式。 | ||
| deviceModelAllowlist | Object | 终端型号白名单。 | deviceModelAllowlist | |
| macAddressAllowlist | Object | MAC 地址白名单。 | macAddressAllowlist |
表 deviceModelAllowlist
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| enable | Boolean | 是否启用当前终端型号白名单。 | ||
| entries | Array of Strings | 终端型号白名单条目。 最多100条。 始终返回非null集合。 启用时允许为空。 |
表 macAddressAllowlist
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| enable | Boolean | 是否启用当前MAC地址白名单。 | ||
| entries | Array of Strings | MAC地址白名单条目。 最多100条。 始终返回非null集合。 启用时允许为空。 |
枚举参数
无
请求示例
请求url
https://{host}?regionId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&strategyOid=dsy-xxxxxx
请求头header
无
请求体body
无
响应示例
{
"statusCode":800,
"message":"OK.",
"returnObj":{
"strategyOid":"dsy-xxxxxx",
"runMode":{
"priority":"STRATEGY",
"mode":"LOCKED",
"deviceModelAllowlist":{
"enable":true,
"entries":["CTDesk-T10"]
},
"macAddressAllowlist":{
"enable":true,
"entries":["00:11:22:33:44:55"]
}
}
}
}
状态码
请参考 状态码
错误码
请参考 错误码
