接口功能介绍
设置访问云电脑的IP和MAC限制
接口约束
无
URI
POST /v3/desktop/batch/setAccessIpAndMac
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 | d8bbd132b53a11e9b0e40242ac110002 |
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| desktopOidList | 是 | Array of Strings | 云电脑ID列表，可设置一个或多个，最多10个 | D0023092101180485 | |
| externalIpListString | 是 | String | 外网IP地址;支持单个IP地址或IP段,最多可输入50条数据;格式:203.56.24.243,203.56.24.0/24,203.56.24.1-203.56.24.111 | 192.168.0.1 | |
| ipListString | 是 | String | 客户端IP地址;支持单个IP地址或IP段,最多可输入50条数据;格式:192.168.1.1，192.168.1.0/24，192.168.1.1-192.168.1.111 | 192.168.1.1 | |
| macListString | 是 | String | MAC地址;最多可输入50条数据;格式:5B:FB:84:3B:74:BF 或 5B-FB-84-3B-74-BF | 5B-FB-84-3B-74-B | |
| hardwareCodeListString | 是 | String | 设备唯一码;最多可输入50条数据;例如windows 主板 UUID格式：A6171E1D-C26C-41EE-BFBA-28D3F3E01480 | A6171E1D-C26C-41EE-BFBA-28D3F3E01480 | |
| routerMacListString | 是 | String | 限制路由器MAC地址;最多可输入50条数据，格式: 5B:FB:84:3B:74:BF 或 5B-FB-84-3B-74-BF | 5B:FB:84:3B:74:BF 或 5B-FB-84-3B-74-BF |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码。可能值： - 800：请求成功。 - 900：请求失败。 |
800 | |
| error | String | 错误码。 | ||
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 返回数据结构体。 | { } | returnObj |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{"desktopOidList":["XXXXXXXXXXXXX6925"],"externalIpListString":"123.123.123.123","ipListString":"","macListString":"","hardwareCodeListString":"","routerMacListString":""}
响应示例
{"statusCode":800,"message":"OK.","returnObj":{ }}
状态码
请参考 状态码
错误码
请参考 错误码
