setEthernet.lua
[返回首页]

API说明

修改一个有线以太网连接

参数

HTTP提交参数:POST

通过HTTP测试该API调用 (URL):

DeviceObject

可选参数。如果指定,则为网络接口的ObjectID(参见getNetInterface.lua);如果没有指定,则为默认的Ethernet接口

测试值:

Object
(必需参数)

要修改Ethernet连接的Object名称(通过getEthernetDetail.lua可以获得 [ConnectionObject参数])

测试值:

Uuid
(必需参数)

该连接的Uuid(通过getEthernetDetail.lua 可以获得)

测试值:

CloneMac

可选参数。如果指定了CloneMac(且不为空字符串),则可以修改以太网的MAC地址。

测试值:

DHCP
整数

1

使用DHCP获取地址

0

手动指定IP地址。如果指定DHCP=0,则以下参数(参数组Manual-IP)需要指定。

测试值:

参数组: Manual-IP

手动指定IP地址参数组。本组参数包括:IP, Mask, Prefix, Gateway, Dns1, Dns2

允许这个参数组:

>   IP
[隶属于参数组 Manual-IP]

手动指定的IP地址

测试值:

>   Mask
[隶属于参数组 Manual-IP]

手动指定子网掩码

测试值:

>   Prefix
[隶属于参数组 Manual-IP]

以prefix形式指定的子网掩码(注:可选,与Mask参数二选一即可)

测试值:

>   Gateway
[隶属于参数组 Manual-IP]

手动指定默认网关

测试值:

>   Dns1
[隶属于参数组 Manual-IP]

指定DNS1 (或为空)

测试值:

>   Dns2
[隶属于参数组 Manual-IP]

指定DNS2 (或为空)

测试值:

返回

返回JSON格式的结果。该JSON数据的格式如下:

{
/*对象*/

"Result":
数值

200表示OK, 其它错误码含义类似于HTTP Response.

"Status":
"字符串"

状态消息。反馈API执行的结果状态,如有错误,将描述出错的原因。

}

说明

调用本API修改以太网连接参数后,参数不会立即生效,除非重启设备或调用connectEthernet.lua重新连接。

其它说明

KILOVIEW Device HTTP API, v1.0