检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如果命令下发需要超过20秒，建议采用消息下发。 注意： 此接口适用于MQTT设备
添加设备组 功能介绍 应用服务器可调用此接口新建设备组，一个华为云账号下最多可有1,000个设备组，包括父设备组和子设备组。设备组的最大层级关系不超过5层，即群组形成的关系树最大深度不超过5。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group
灵活搜索设备列表 功能介绍 接口说明 应用服务器使用SQL语句调用该接口，灵活的搜索所需要的设备资源列表 限制 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数) 类SQL语法使用说明 类SQL语句由select
功能介绍 应用服务器可调用此接口在物联网平台创建一个设备，仅在创建后设备才可以接入物联网平台。 该接口支持使用gateway_id参数指定在父设备下创建一个子设备，并且支持多级子设备，当前最大支持二级子设备。 该接口同时还支持对设备进行初始配置，接口会读取创建设备请求参数prod
请求响应的状态，完整的状态码列表请参见状态码。 对于创建产品接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”等。 对于创建产品接口，平台会返回“Content-type”、Date等消息头。 响应消息体
删除自定义鉴权 功能介绍 应用服务器可调用此接口在物联网平台上删除指定自定义鉴权。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/device-authorizers/{authorizer_id} 表1 路径参数 参数 是否必选
删除OTA升级包 功能介绍 用户可调用此接口删除关联OBS对象的升级包信息，不会删除OBS上对象 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM）
删除实例 功能介绍 删除设备接入实例。约束：此接口仅支持删除按需计费的实例。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/iotda-instances/{instance_id} 表1 路径参数 参数 是否必选 参数类型 描述
功能介绍 应用服务器可调用此接口上传批量任务文件，用于创建批量任务。当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件上传。 批量注册设备模板 批量删除设备模板 批量冻结设备模板 批量解冻设备模板 调用方法 请参见如何调用API。 URI POST /
创建规则动作 功能介绍 应用服务器可调用此接口在物联网平台创建一条规则动作。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/routing-rule/actions 表1 路径参数 参数 是否必选 参数类型 描述 project_id
创建规则触发条件 功能介绍 应用服务器可调用此接口在物联网平台创建一条规则触发条件。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/routing-rule/rules 表1 路径参数 参数 是否必选 参数类型 描述 project_id
管理设备组中的设备 功能介绍 应用服务器可调用此接口管理设备组中的设备。单个设备组内最多添加20,000个设备，一个设备最多可以被添加到10个设备组中。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group/{group_id}/action
等, 详情参考设备命令状态变更通知。 注意： 此接口适用于NB设备异步命令下发，暂不支持其他协议类型设备命令下发。 此接口仅支持单个设备异步命令下发，如需多个设备异步命令下发，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/iot/{proje
从控制台获取项目ID 在调用接口时，部分URI以及请求体中需要填入项目ID，项目ID获取步骤如下： 在华为云首页右上角，单击“控制台”。 在右上角的用户名中选择“我的凭证”。 在“我的凭证”界面，API凭证页签中，查看项目ID。 图1 API凭证-获取项目ID 调用API获取项目ID 项目
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 表3 请求Body参数
修改设备接入实例的计费模式，支持将按需计费模式修改为包年/包月计费模式。 接口约束：当前实例的规格支持包年/包月计费模式时，才可以修改实例的计费模式为包年/包月。支持的实例规格请参见产品规格说明。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 表3 请求Body参数
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 表3 请求Body参数
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 表3 请求Body参数
Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 调用获取IAM用户Token（使用密码）接口获取Token，调用样例如下： POST https://iam.cn-north-4
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
