检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用全球SIM联接服务的设备接入到物联网平台时，可能会面临网络信号强度弱，信号有时延等问题。当应用服务器接收到设备上报的网络信号强度数据时，您可以通过命令下发的方式切换运营商网络。 整体流程 按需选网整体流程如下图所示。 设备在集成SDK Tiny后，还需要完成切换网络命令转换成AT指令的开发，以完成设备网络的自动切换。
细查看命令下发任务的创建时间、平台发送命令的时间、送达的时间、发送的状态等信息，便于用户了解命令的执行状态。 命令下发支持通过调用查询设备命令接口，在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况。 配置应用侧使用JAVA SDK进行同步命令下发的开发步骤如下，本示例使用的开发环境为JDK
物联网平台根据升级的目标版本判断设备是否需要升级。（第4步等待设备上报软件版本，超时时间为3分钟） 如果返回的软件版本信息与升级的目标版本信息相同，则升级流程结束，不做升级处理。 如果返回的软件版本信息与升级的目标版本信息不同，则继续进行下一步的升级处理。 6. 物联网平台向设备订阅软件升级的状态。
该接口仅支持配置单个设备的设备影子的预期数据，如需多个设备的设备影子配置，请参见 创建批量任务。 限制： 设备影子JSON文档中的key不允许特殊字符：点(.)、dollar符号($)、空char(十六进制的ASCII码为00)。如果包含了以上特殊字符则无法正常刷新影子文档。 调用方法 请参见如何调用API。
channel String 推送异常的数据转发目标类型。 base64_original_payload String 经过Base64编码的原始流转数据。 error_message String 错误的描述和说明。 异常转发数据格式可能存在增加字段的情况，在使用的时候务必做好序列化兼容性。
获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时
是指设备无法按照产品模型中定义的属性格式进行数据上报时，可调用此接口将设备的自定义数据格式上报给平台，平台对该消息不进行解析，该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构
注册单个设备 归属于某个产品下的设备实体，每个设备具有一个唯一的标识码。设备可以是直连物联网平台的设备，也可以是代理子设备连接物联网平台的网关。您可以在物联网平台注册您的实体设备，通过平台分配的设备ID和密钥，在集成了SDK后，您的设备可以接入到物联网平台，实现与平台的通信及交互。 物联网
Object 参数说明：设备所属的产品id，可以是一个明确的静态字符串id，也可以是动态的模板参数引用 明确的静态字符串："642bf260f2f9030e44210d8d"。取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。" 参数引用: {"ref"
获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时
将会根据service_id和desired设置的属性值与产品中对应属性的默认值比对，如果不同，则将以shadow字段中设置的属性值为准写入到设备影子中。service_id的值和desired内的属性必须是profile中定义的。 表4 AuthInfo 参数 是否必选 参数类型
类型 参数描述 service_id 必选 String 参数解释： 设备的服务ID，由创建的产品模型确定。 properties 必选 Object 参数解释： 设备服务的属性列表，具体字段在设备关联的产品模型里定义，可以设置多个字段。 event_time 可选 String
Name），唯一标识函数，即自定义鉴权器对应的处理函数地址。 signing_enable Boolean 参数说明：是否启动签名校验，启动签名校验后不满足签名要求的鉴权信息将被拒绝，以减少无效的函数调用。推荐用户进行安全的签名校验，默认开启。 signing_token String 参数说明：签名校验的Key值，开启签名校验时使用。
灵活搜索设备列表 应用服务器使用SQL语句调用该接口，灵活的搜索所需要的设备资源列表。 查询指定设备加入的设备组列表 应用服务器调用该接口查询设备加入的设备组列表。 设备消息 API 说明 查询设备消息 查询指定设备下的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。
Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。
产品模型定义了该产品下所有设备具备的能力或特征，产品管理为应用服务器提供对已导入物联网平台中产品模型的操作管理功能。 设备管理 设备管理为应用服务器提供对设备的操作管理功能，包括对设备基本信息和设备数据的操作。 设备消息 设备消息为应用服务器提供向设备透传消息的功能。 设备命令 设备的产品模型中定义
+HMCON OK（连接成功） serverip：设备接入服务器地址或者BS服务器地址。 默认值：BS服务器地址 +HMCON ERR：code（连接失败，code表示失败原因码） serverport：设备接入服务器端口或者BS服务器端口。 默认值：MQTTS端口8883 - id：设备ID，最大长度256。
将设备上报的二进制码流解码成JSON格式的数据，发送给应用服务器。 将应用服务器响应的JSON格式数据编码成二进制码流，下发给设备。 命令下发流程 图2 命令下发流程图 在命令下发流程中，有两处需要用到编解码插件： 将应用服务器下发的JSON格式数据编码成二进制码流，下发给设备。 将设备响应的二进制码流解码
gateway_id String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 device_name String
OCSP校验：本文统一指定为物联网平台对设备侧证书的有效性校验。 OCSP装订（OCSP Stapling）：也称服务端OCSP，是TLS证书状态查询扩展，作为在线证书状态协议的替代方法对X.509证书状态进行查询，服务器主动检查自身证书状态，在TLS握手时发送已缓存的OCSP响应，用户只需验证该响应的时效性而不用再
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
