检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
当上报的数据为某个命令的响应时，“pcRequstId”必须与下发命令中的requstId保持一致。“pcRequestId”可以从广播中获取，请参考API文档中“设备命令接收”接口的“EN_IOTA_DATATRANS_IE_REQUESTID”参数。 “pcService
基础（WaterMeterBasic） 用于定义水表上报的水流量、水温、水压等参数，如果需要命令控制或修改这些参数，还需要定义命令的参数。 告警（WaterMeterAlarm） 用于定义水表需要上报的各种告警场景的数据，必要的话需要定义命令。 电池（Battery） 定义水表的电压、电流强度等数据。
参数说明 字段 必选/可选 类型 描述 uiCookie 可选 unsign int Cookie有效值1-65535。 pcRequstId 必选 String 请求ID，用来匹配之前平台下发的服务命令。当该次数据上报为此前某一次命令请求的响应时，需要填写此次命令请求的请求ID，该参数必须带结束符‘\0’。
设备服务信息，增量上报，具体参见ServiceInfo结构体。 ServiceInfo结构体说明： 参数 必选/可选 类型 位置 描述 muteCmds 可选 List<String> body 屏蔽的设备控制命令列表。 响应参数 Status Code: 200 OK 请求示例 Method: POST
执行该动作。 命令请求ID：用于标识此次命令下发的ID。 回调地址：命令状态变化通知地址，当命令状态变化时(执行失败，执行成功，超时，发送，已送达)会通知应用服务器。 过期时间（秒）：命令有效的超期时间，单位为秒。当为0时，表示立即下发命令，其他值表示缓存下发命令。不传时，默认为48小时。
roupInDTO cdgInDTO, String accessToken) throws NorthApiException 参数说明 参数 必选/可选 类型 位置 描述 cdgInDTO 必选 CreateDeviceGroupInDTO body 见下表CreateDeviceGroupInDTO的描述。
次对同一设备仅下发一条命令，在收到命令执行结果响应后，再下发下一条命令。 编解码插件可以在命令响应消息的resultDetail里加上命令的相关信息来帮助识别命令，比如命令码。应用服务器根据resultDetail里的信息来识别命令执行结果响应和已下发命令的对应关系。 禁止使用DirectMemory
mdsInDTO, deviceId, appId, accessToken) 接口所属类 DeviceManagement 参数说明 参数 必选/可选 类型 位置 描述 mdsInDTO 必选 ModifyDeviceShadowInDTO body 见下表ModifyD
在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。 接口描述 1 def createDeviceGroup(self, cdgInDTO, accessToken) 参数说明 参数 必选/可选 类型
DeviceManagement 参数说明 参数 必选/可选 类型 位置 描述 deviceId 必选 String(256) path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 appId 必选 String query 如果是本应用的设备，此参数值可以填写null，否则填写授权应用的appId。
当设备主动上报数据时，“requstId”可以为空。 当上报的数据为某个命令的响应时，“requstId”必须与下发命令中的“requstId”保持一致。requestId可以从广播中获取，请参考API文档中“设备命令接收”接口的广播参数“DATATRANS_IE_REQUESTID”的说明。
请求方法 PUT URI /iocm/app/shadow/v1.5.0/devices/{deviceId} 传输协议 HTTPS 请求参数 参数 必选/可选 类型 位置 描述 app_key 必选 String header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。
DeviceManagement 参数说明 参数 必选/可选 类型 位置 描述 deviceId 必选 String path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 appId 必选 String query 如果是本应用的设备，此参数值可以填写null，否则填写授权应用的appId。
关于平台上的事件种类和推送的消息样例，请参考推送通知。 https推送的前提是先在平台上上传应用服务器的CA证书。 命令下发 本部分接口提供命令的创建、删除、查询、批量创建等功能。 批量处理 目前仅支持创建批量下发缓存命令任务，您也可以查询批量任务信息。 设备组管理 应用服务器可以通过本部分接口在物联网平台上
DeviceManagement 参数说明 参数 必选/可选 类型 位置 描述 deviceId 必选 String path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 appId 可选 String query 如果是本应用的设备，此参数值可以填写None，否则填写授权应用的appId。
屏蔽的设备服务信息，增量上报，具体参见ServiceInfo结构体。 ServiceInfo结构体说明： 参数 必选/可选 类型 位置 描述 muteCmds 可选 List<String> body 屏蔽的设备控制命令列表。 响应参数 Status Code: 200 OK 请求示例 Method: POST
能不再做增强，新增功能仅在新版本接口中提供。 应用在接收处理物联网平台发送的响应消息和推送消息时，需要兼容或忽略消息中的新增参数，不能因为消息中的新增参数导致应用的处理异常。 应用在调用API时，需要预置平台提供的CA证书，可点击证书文件获取。 调用API的其他使用限制，请参见物联网平台的使用限制。
必选 指示设备可以执行的命令，如果本服务无命令则置null。 commandName 必选 指示命令的名字，命令名与参数共同构成一个完整的命令。 paras 必选 命令包含的参数。 paraName 必选 命令中参数的名字。 dataType 必选 指示命令参数的数据类型。 取值范围：string、int、string
接口所属类 DataTransService 参数说明 字段 必选/可选 类型 描述 cookie 可选 int Cookie有效值1-65535。 requstId 必选 String 请求ID，匹配之前平台下发的服务命令。可以从接收设备命令的广播中获取requestId。 主动数据上报：requestId为NULL。
*pcStatusDetail); 参数说明 字段 必选/可选 类型 描述 uiCookie 可选 HW_UINT Cookie有效值为1-65535。 pcDeviceId 必选 HW_CHAR 设备Id，该参数必须带结束符‘\0'。 pcStatus 必选 HW_CHAR 设备状态，该参数必须带结束符‘\0'。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
