华为云首页用户手册

设备接入 IOTDA-产品更新通知:请求参数

设备接入 IOTDA-产品更新通知:请求参数

时间：2024-06-28 09:24:57

设备接入 IOTDA

请求参数

表1 请求Body参数
参数	是否必选	参数类型	描述
resource	是	String	参数说明：订阅的资源名称，取值为product。
event	是	String	参数说明：订阅的资源事件，取值为update。
event_time	是	String	参数说明：资源事件生成时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。若需要显示本地时区，您需要自己进行时间转换。
event_time_ms	否	String	参数说明：资源事件生成时间,格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z' UTC字符串，如：2015-12-12T12:12:12.000Z。若需要显示本地时区，您需要自己进行时间转换。
request_id	否	String	参数说明：消息ID，由设备侧指定或平台生成，用于跟踪业务流程。
notify_data	是	ProductUpdateNotifyData object	参数说明：推送消息。

表2 ProductUpdateNotifyData
参数	是否必选	参数类型	描述
body	是	Product object	参数说明：推送消息内容。

表3 Product
参数	是否必选	参数类型	描述
app_id	否	String	参数说明：资源空间ID。
app_name	否	String	参数说明：资源空间名称。
product_id	否	String	参数说明：产品ID，用于唯一标识一个产品，在物联网平台创建产品后由平台分配获得。
name	否	String	参数说明：产品名称。
device_type	否	String	参数说明：设备类型。
protocol_type	否	String	参数说明：设备使用的协议类型。取值范围：MQTT，CoAP，HTTP，HTTPS，Modbus，ONVIF。
data_format	否	String	参数说明：设备上报数据的格式，取值范围：json，binary。
manufacturer_name	否	String	参数说明：厂商名称。
industry	否	String	参数说明：设备所属行业。
description	否	String	参数说明：产品的描述信息。
service_capabilities	否	Array of ServiceCapability objects	参数说明：设备的服务能力列表。
create_time	否	String	参数说明：在物联网平台创建产品的时间，格式：yyyyMMdd'T'HHmmss'Z'，如20151212T121212Z。

表4 ServiceCapability
参数	是否必选	参数类型	描述
service_id	是	String	参数说明：设备的服务ID。
service_type	是	String	参数说明：设备的服务类型。
properties	否	Array of ServiceProperty objects	参数说明：设备服务支持的属性列表。
commands	否	Array of ServiceCommand objects	参数说明：设备服务支持的命令列表。
events	否	Array of ServiceEvent objects	参数说明：设备服务支持的事件列表。
description	否	String	参数说明：设备服务的描述信息。
option	否	String	参数说明：指定设备服务是否必选。Master（主服务）, Mandatory（必选服务）, Optional（可选服务），目前本字段为非功能性字段，仅起到标识作用。默认为Optional（可选服务）。缺省值：Optional

表5 ServiceProperty
参数	是否必选	参数类型	描述
property_name	是	String	参数说明：设备属性名称。
required	否	Boolean	参数说明：设备属性是否必选。默认为false。缺省值：false
data_type	是	String	参数说明：设备属性的数据类型。取值范围：int，long，decimal，string，DateTime，jsonObject，enum，boolean，string list。
enum_list	否	Array of strings	参数说明：设备属性的枚举值列表。
min	否	String	参数说明：设备属性的最小值。最小长度：1 最大长度：16
max	否	String	参数说明：设备属性的最大值。最小长度：1 最大长度：16
max_length	否	Integer	参数说明：设备属性的最大长度。
step	否	Double	参数说明：设备属性的步长。
unit	否	String	参数说明：设备属性的单位。最大长度：16
method	是	String	参数说明：设备属性的访问模式。取值范围：RWE，RW，RE，WE，E，W，R。 R：属性值可读 W：属性值可写 E：属性值可订阅，即属性值变化时上报事件。
description	否	String	参数说明：设备属性的描述。
default_value	否	Object	参数说明：设备属性的默认值。如果设置了默认值，使用该产品创建设备时，会将该属性的默认值写入到该设备的设备影子预期数据中，待设备上线时将该属性默认值下发给设备。

表6 ServiceCommand
参数	是否必选	参数类型	描述
command_name	是	String	参数说明：设备命令名称。
paras	否	Array of ServiceCommandPara objects	参数说明：设备命令的参数列表。
responses	否	Array of ServiceCommandResponse objects	参数说明：设备命令的响应列表。

表7 ServiceCommandResponse
参数	是否必选	参数类型	描述
paras	否	Array of ServiceCommandPara objects	参数说明：设备命令响应的参数列表。
response_name	是	String	参数说明：设备命令响应名称。

表8 ServiceEvent
参数	是否必选	参数类型	描述
event_type	是	String	参数说明：设备事件类型。
paras	否	Array of ServiceCommandPara objects	参数说明：设备事件的参数列表。

表9 ServiceCommandPara
参数	是否必选	参数类型	描述
para_name	是	String	参数说明：参数的名称。
required	否	Boolean	参数说明：参数是否必选。默认为false。缺省值：false
data_type	是	String	参数说明：参数的数据类型。取值范围：int，long，decimal，string，DateTime，jsonObject，enum，boolean，string list。
enum_list	否	Array of strings	参数说明：参数的枚举值列表。
min	否	String	参数说明：参数的最小值。最小长度：1 最大长度：16
max	否	String	参数说明：参数的最大值。最小长度：1 最大长度：16
max_length	否	Integer	参数说明：参数的最大长度。
step	否	Double	参数说明：参数的步长。
unit	否	String	参数说明：参数的单位。最大长度：16
description	否	String	参数说明：参数的描述。

上一篇：设备接入 IOTDA-产品更新通知:请求示例

下一篇：设备接入 IOTDA-创建网桥:请求参数

新客秒杀 2核2G 3M L实例

68元/年

普惠上云领千元上云礼券

立即前往

企业专享 X实例 4核8G 5M

888元/年

热门域名 1元随心购

1元/年起

设备接入 IOTDA-产品更新通知:请求参数

意见反馈

0/200

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

推荐文章

解决方案
相关专题