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

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

参数说明

参数

必选/可选

类型

位置

描述

commandDTO

必选

CommandDTO

body

见下表CommandDTO的描述。

deviceId

必选

String(1-64)

path

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

serviceId

必选

String(1-64)

path

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

appId

可选

String

query

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

accessToken

必选

String

header

填写鉴权接口获取的accessToken。

CommandDTO

参数

必选/可选

类型

位置

描述

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_2464.html