设备重命名
重命名指定设备。
仅管理员有权限。
接口原型
协议 | HTTP/HTTPS GET |
URL | ip[:port]/path?method=xxx&name=xxx&sc-client-id=xxx |
数据格式 | 响应消息:Content-Type: application/json |
请求URL参数
- 不同产品族对应的URL参数不同。
产品族 | path | method |
---|---|---|
Ultra Stream | socket/usapi | set-name |
Ultra Encode | socket/usapi | set-name |
Pro Convert编码器 | socket/mwapi | set-eth-config |
Pro Convert解码器 | socket/mwapi | set-eth-config |
- 参数说明如下:
参数 | 描述 |
---|---|
method | 方法名。参见上表method。 |
name | 设备的新名称。 |
sc-client-id | 重命名设备的序列号。 |
请求Cookies
名称 | 描述 |
---|---|
mwcloud-sid | 用于标识当前登录的字符串 |
mwcloud-uid | 当前登录用户名 |
请求示例
不同设备修改名称的方式不一样。
Ultra Stream、Ultra Encode:
GET /socket/usapi?method=set-name&name=Encode&sc-client-id=A305200908004 HTTP/1.1 Accept: application/json, text/plain, */* Connection: keep-alive Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin
Pro Convert编码器、Pro Convert解码器:
GET /socket/mwapi?method=set-eth-config&name=Convert&sc-client-id=A421210928002 HTTP/1.1 Accept: application/json, text/plain, */* Connection: keep-alive Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin
响应参数
Response Header
参数 | 描述 |
---|---|
Content-Type | 取值为:'application/json |
Response Body
参数 | 描述 |
---|---|
result | 返回码。
|
status | 返回码。
|
响应示例
不同设备的响应不一样。
Ultra Stream、Ultra Encode:
HTTP/1.1 200 OK Content-Type: application/json { "result": 0 }
Pro Convert编码器、Pro Convert解码器:
HTTP/1.1 200 OK Content-Type: application/json { "status": 0, "reconnect": true }