检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
是否必选 参数类型 描述 tag_key 是 String 参数说明：标签键，在同一资源下标签键唯一。绑定资源时，如果设置的键已存在，则将覆盖之前的标签值。如果设置的键值不存在，则新增标签。 tag_value 否 String 参数说明：标签值。 表5 DeviceCommandStatusUpdate
设备接入物联网平台后，应用服务器可通过以下方式发送指令到设备。 平台消息下发：用于平台下发自定义格式的数据给设备。 平台设置设备属性：设备的产品模型中定义了平台可向设备设置的属性，应用服务器可通过属性设置的方式修改指定设备的属性值。 平台查询设备属性：应用服务器通过属性查询的方式，实时查询指定设备的属性数据。
支持对设备进行分组或打标签，详细请参见群组与标签。 设备物模型定义 对设备进行物模型定义（Product Model），详细请参见产品模型。 设备影子 支持影子数据查询和影子设置，详细请参见设备影子。 OTA升级 支持对设备软固件进行升级，详细请参考OTA升级。 设备文件上传 支持设备上传文件到OBS，设备可向云端请求文件，详细请参见文件上传。
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。该接口仅支持删除单个设备，如需批量删除设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
No；若没有真实设备，填写自定义字符串，由英文字母、数字、连接号-和下划线_组成。 设备ID 设备ID，用于唯一标识一个设备。如果携带该参数，平台将设备ID设置为该参数值；如果不携带该参数，设备ID由物联网平台分配获得，生成规则为product_id + _ + node_id拼接而成。 设备名称
管理设备组中的设备 功能介绍 应用服务器可调用此接口管理设备组中的设备。单个设备组内最多添加20,000个设备，一个设备最多可以被添加到10个设备组中。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group/{group_id}/action
每个设备有且只有一个设备影子，由设备ID唯一标识 - 设备影子用于存储设备上报的属性和应用程序期望的设备属性 - 无论该设备是否在线，都可以通过该影子获取和设置设备的状态 查询设备影子数据 配置设备影子预期数据 父主题： API
直接进行下发，下发成功后接口返回DELIVERED，失败返回FAILED；如果消息在平台默认时间内（1天）还没有下发给设备，则平台会将消息设置为超时，状态为TIMEOUT。另外应用可以订阅消息的执行结果，平台会将消息结果推送给订阅的应用。 created_time String
IoTDA为项目级服务，授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如华南-广州）对应的项目（cn-south-1）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问IoTDA时，需要先切换至授权区域。 设备接入提供“角色”和“策略”两种维度的权限管理。
自定义，如“数据转发至RocketMQ”。 数据来源 选择“设备属性”。 触发事件 自动匹配“设备属性上报”。 资源空间 选择“所有资源空间”。 单击“设置转发目标”页签，单击“添加”，设置转发目标，设置完成后单击“确定”按钮。 表2 创建转发目标参数说明 参数名 参数说明 转发目标 选择“分布式消息服务（RocketMQ）”。
403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405
自定义，如“数据转发至DIS”。 数据来源 选择“设备属性”。 触发事件 自动匹配“设备属性上报”。 资源空间 选择“所有资源空间”。 单击“设置转发目标”页签，单击“添加”，设置转发目标，设置完成后单击“确定”按钮。 表2 转发目标参数说明 参数名 参数说明 转发目标 选择“数据接入服务（DIS）”。 区域
用于设备按产品模型中定义的格式将事件数据上报给平台。 数据下行 平台消息下发 用于平台下发自定义格式的数据给设备。 平台设置设备属性 设备的产品模型中定义了平台可向设备设置的属性，平台/应用服务器可通过属性设置的方式修改指定设备的属性值。 平台查询设备属性 平台/应用服务器通过属性查询的方式，实时查询指定设备的属性数据。
设备的升级进度。 取值范围： 0到100。 version 必选 String 参数解释： 设备当前版本号（升级完成时上报的版本号要与上传软固件包时在平台设置的版本号一致）。 description 可选 String 参数解释： 升级状态描述信息，可以返回具体升级失败原因。 示例 Topic:
创建AMQP队列 功能介绍 应用服务器可调用此接口在物联网平台创建一个AMQP队列。每个租户只能创建100个队列，若超过规格，则创建失败，若队列名称与已有的队列名称相同，则创建失败。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/amqp-queues
什么是产品模型 产品模型用于描述设备具备的能力和特性。开发者通过定义产品模型，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息，如开关等。当定义完一款产品模型后，在进行注册设备时，就可以使用在控制台上定义的产品模型。 产品模型定义了服务能力： 服务能力
NB-IoT设备OTA升级 LwM2M协议设备软件升级流程 LwM2M协议SOTA升级流程的详细说明： 1～2. 用户在设备管理服务的控制台上传软件包，并在控制台或者应用服务器上创建软件升级任务。 3. LwM2M设备上报数据，平台感知设备上线，触发升级协商流程。(超时时间为24小时)
description 否 String 参数说明：设备属性的描述。 default_value 否 Object 参数说明：设备属性的默认值。如果设置了默认值，使用该产品创建设备时，会将该属性的默认值写入到该设备的设备影子预期数据中，待设备上线时将该属性默认值下发给设备。 表6 ServiceCommand
选择“设备属性”。 触发事件 自动匹配“设备属性上报”。 资源空间 选择转发的数据来源所属的资源空间，或者所有资源空间。 单击“设置转发目标”页签，单击“添加”，设置转发目标。 参数名 参数说明 转发目标 选择“文档数据库服务DDS” 数据库实例地址 填写数据库实例的连接IP（或域名）和
description 否 String 参数说明：设备属性的描述。 default_value 否 Object 参数说明：设备属性的默认值。如果设置了默认值，使用该产品创建设备时，会将该属性的默认值写入到该设备的设备影子预期数据中，待设备上线时将该属性默认值下发给设备。 表6 ServiceCommand
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
