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