智慧服务，成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 服务端API参考 > 硬终端管理 批量修改终端状态

入门使用

批量修改终端状态

更新时间：2019-11-20

描述

企业管理员通过该接口批量修改终端状态。

接口原型

表1 接口原型

请求方法

PUT

请求地址

/rest/usg/datacenter/v1/corp/device/status/{value}

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

Authorization

是

String

Header

授权令牌。将执行鉴权响应的accessToken

进行Base64转码操作。

样例：Basic Base64(accessToken)

value

是

Integer

URL

状态。

  • 0：启用
  • 1：停用

snList

是

String[0..*]

Body

终端序列号列表，当SN对应的终端状态一致的，则忽略该记录。

响应参数

表3 参数说明

参数

类型

描述

returnCode

String

业务返回码。

returnMessage

String

返回描述。

achievementTime

String

响应产生时间。

requestId

String

请求唯一标识。

请求消息示例

PUT /rest/usg/datacenter/v1/corp/device/status/0 
Connection: keep-alive
Authorization: Basic UXJ0SFVvcFgyTGdYYzVZam5TeXhOV1M2OVRXRnVDSzlX
Content-Type: application/json
Content-Length: 47
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

["GFF4WLAOAOPWXLZ2BK5C","9CEQWDOEMSXFSCQULRCW"]
 

响应消息示例

HTTP/1.1 200
Date: Tue, 16 Apr 2019 06:30:46 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 143
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Server: api-gateway
X-Request-Id: 702639ba08cda213b2699300e7f166e8 

{
    "returnCode": "000000000",
    "returnMessage": "Success",
    "achievementTime": "2019-04-16 06:29:28.352",
    "requestId": "702639ba08cda213b2699300e7f166e8"
}
 

CURL命令示例

curl -k -i -H 'content-type: application/json' -X PUT -H 'Authorization:Basic T3IxeXdMUGwzeU9Gb3JnWENNWWZldnBHM0JTQVA5N2FS' -d '["GFF4WLAOAOPWXLZ2BK5C","9CEQWDOEMSXFSCQULRCW"]' https://api.meeting.huaweicloud.com/rest/usg/datacenter/v1/corp/device/status/0