检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
callbackUrl 必选 String body 订阅的回调地址，用于接收对应类型的通知消息。 可使用HTTPS或HTTP回调地址，建议使用HTTPS。回调地址支持IP地址或域名格式，同时回调地址中必须指定回调地址的端口。例如：https://XXX.XXX.XXX.XXX:443/callbackurltest。
回调地址可以修改吗？ 可以。如果回调地址的IP和端口号需要更换，需要调用“批量删除订阅”接口，删除之前的回调地址后，并上传新的CA证书，再重新订阅。 父主题： 订阅推送（联通用户专用）
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接
创建订阅 接口说明 应用服务器可调用此接口订阅物联网平台资源的变化事件，当资源发生变化时（如设备激活，设备数据更新等），平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS
设备消息状态变更通知 接口说明 应用服务器在物联网平台订阅了消息状态变更通知后（订阅的资源为device.message.status，事件为update），当消息状态变更时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
批量任务状态变更通知 接口说明 应用服务器在物联网平台订阅了批量任务状态变更通知后（订阅的资源为batchtask.status，事件为update），当批量任务状态变更时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
接口说明 应用服务器在物联网平台订阅了设备消息上报通知后（订阅的资源为device.message，事件为report），当设备上报消息数据时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}
接口说明 应用服务器在物联网平台订阅了设备属性变化通知后（订阅的资源为device.data，事件为update），当设备上属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备属性变化通知的callbackUrl决定
callbackUrl 必选 String(1024) body 订阅的回调地址，用于接收对应类型的通知消息。 可使用HTTPS或HTTP回调地址，建议使用HTTPS。回调地址支持IP地址或域名格式，同时回调地址中必须指定回调地址的端口。例如：https://XXX.XXX.XXX.XXX:443/callbackurltest
调用订阅接口时，回调地址如何获取？ 应用服务器如何收到命令状态变化的通知？ 如何获取证书？ 回调地址可以使用域名吗？ 订阅后消息推送失败，例如提示503如何处理？ 应用服务器收到数据，但是平台显示推送失败？ 应用服务器只有内网地址，能否订阅成功？ 调用订阅接口时，提示回调地址不合法？ 物联网平台只支持HTTPS的回调地址吗？
刷新token 接口说明 应用服务器通过鉴权接口获取到的accessToken是有效时间的，在accessToken快过期时，应用服务器通过调用此接口，获取新的accessToken。 URI 请求方法 POST URI /iocm/app/sec/v1.1.0/refreshToken
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后（资源为device.status，事件为update），当物联网平台中的设备状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
Profile（即产品模型）是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile，因为Profile里面定义了设备上报的数据和应用服务器下发的命令包含了哪些字段。定义Profile，即在物联网平台构建一款设备的抽象
据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。应用服务器可调用此接口在设备影子上修改要下发给设备的配置信息。
设备接入服务如何获取设备数据？ 设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题：
回调地址可以使用域名吗？ 可以，IP和域名都支持。 使用域名时，如果域名绑定多个IP，需要做好DNS解析，确保DNS解析后的IP地址可达。这种情况下，推荐使用IP地址作为回调地址。 父主题： 订阅推送（联通用户专用）
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置，或者查看某种订阅类型下的所有订阅配置，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
