设备管理 IOTDM(联通用户专用)-设备服务调用:参数说明

时间:2024-07-03 16:54:07

参数说明

参数

必选/可选

类型

位置

描述

deviceId

必选

String(1-64)

path

设备ID,用于唯一标识一个设备。

serviceId

必选

String(1-64)

path

服务ID,唯一标识一个服务。

commandDTO

必选

CommandDTO2

body

见下表CommandDTO2的描述。

appId

必选

String

query

如果是本应用的设备,此参数值可以填写null,否则填写授权应用的appId。

accessToken

必选

String

header

如果调用了定时刷新token接口,此参数值可以填写null,否则要填写鉴权接口获取的accessToken。

CommandDTO2

参数

必选/可选

类型

位置

描述

header

必选

CommandNA2CloudHeader

body

具体参见CommandNA2CloudHeader结构体。

body

可选

Object

body

消息的消息体。JsonObject里面是一个个健值对。每个健都是profile中命令的参数名(paraName)。

CommandNA2CloudHeader结构体说明:

参数

必选/可选

类型

位置

描述

requestId

可选

String(0-128)

body

用于标识一个命令,不能重复。

mode

必选

Enum

body

是否要确认消息。

  • NOACK:不需要确认消息
  • ACK:需要确认消息
  • 其它值无效

from

可选

String(128)

body

表示消息发布者的地址。

  • App发起的请求:/users/{userId}
  • 第三方应用发起的请求:/{serviceName}
  • 物联网平台 发起的请求:/cloud/{serviceName}

toType

可选

Enum

body

消息接受者的类型,CLOUD/GATEWAY。

to

可选

String(128)

body

消息接收者的地址。

method

必选

String(1-32)

body

命令名称,如:“DISCOVERY”为发现非直连设备,“REMOVE”为删除非直连设备。

callbackURL

可选

String(1024)

body

命令的回调路径。

support.huaweicloud.com/sdkreference-iot/iot_06_2069.html