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

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

入门使用

修改终端

更新时间：2019-11-20

描述

企业管理员通过该接口修改终端。

接口原型

表1 接口原型

请求方法

PUT

请求地址

/rest/usg/datacenter/v1/corp/device/{sn}

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

Authorization

是

String

Header

授权令牌。将执行鉴权响应的accessToken进行Base64转码操作。

样例：Basic Base64(accessToken)

sn

否

String

URL

终端SN号，仅可包含数字、字母和下划线。

长度：1-30。

prjCodeMode

否

Integer

Body

投影码生成模式。

  • 0：自动

    该模式下根据消息上报的IP地址内部控制复杂度。私网地址配置成简单模式，公网地址配置成复杂模式。

  • 1：简单
  • 2：复杂

name

是

String

Body

终端名称，建议为具体位置。

长度：1-64。

deptCode

否

String

Body

部门编号，默认为根部门。

默认值：1

长度：1-32。

phone

否

String

Body

手机号，必须加上国家码。

例如中国大陆手机为“+86xxxxxxxxxxx”，当填写手机号时 “country”参数必填。

手机号只允许输入纯数字。

长度：0-32。

说明：

手机号或者邮箱至少填写一个。

country

否

String

Body

手机号所属的国家。

默认值：chinaPR。

长度：0-255。

email

否

String

Body

统一邮箱格式。

长度：0-255。

description

否

String

Body

终端描述。

长度：0-128。

status

否

Integer

Body

终端状态。

  • 0：正常
  • 1：冻结

默认值：0

响应参数

表3 参数说明

参数

类型

描述

returnCode

String

业务返回码。

returnDesc

String

返回描述。

achievementTime

String

响应产生时间。

requestId

String

请求唯一标识。

请求消息示例

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

{
    "model": "SX20",
    "name": "test",
    "deptCode": "1",
    "phone": "+86136********",
    "email": "test@huawei.com",
    "country": "chinaPR",
    "description": "test",
    "status": 0
}
 

响应消息示例

HTTP/1.1 200 
Date: Tue, 16 Apr 2019 06:07:32 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: 88007a3bf4d6478e530b09589582f26f 

{
    "returnCode": "000000000",
    "returnMessage": "Success",
    "achievementTime": "2019-04-16 06:06:14.095",
    "requestId": "88007a3bf4d6478e530b09589582f26f"
}
 

CURL命令示例

curl -k -i -H 'content-type: application/json' -X PUT -H 'Authorization: Basic T3IxeXdMUGwzeU9Gb3JnWENNWWZldnBHM0JTQVA5N2FS'  -d '{"model": "SX20","name": "test","deptCode": "1","phone": "+86136********","email": "test@huawei.com","country": "chinaPR","description": "test","status": 0}' https://api.meeting.huaweicloud.com/rest/usg/datacenter/v1/corp/device/9CEQWDOEMSXFSCQULRCW