检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM） - 委托”中将委托名称为iotda_admin_trust的委托授权KMS Administrator和OBS
设备属性、应用服务器期望下发的配置（期望值）。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步状态，这个同步可以是影子同步给设备，也可以是设备同步给影子。 数据流转 名词 描述 规则引擎 物联网平台根据用户设置的规则和设备上报的数据，当设备满足设置的条件时，即触
租户在物联网平台上对该设备进行密钥重置并设置强制断链时，物联网平台对该设备进行断链。 操作步骤 访问设备接入服务，单击“管理控制台”，进入设备接入控制台。选择您的实例，单击实例卡片进入。 选择左侧导航栏的“监控运维 > 异常检测”，单击“访问授权”。使用异常检测功能需要授权IoTDA服务对LTS服务进行操作。
服务访问授权操作。 授权成功后可以通过数据转发功能将物联网平台的数据转发到您购买的华为云其他服务，或通过设备联动规则，下发命令控制设备。 同时设备接入服务将在统一身份认证服务（IAM）为您创建名为iotda_admin_trust 的委托，并授权对应的权限，可参考委托授权。 图1
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备，并将设备执行属性结果同步返回。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
查询产品 功能介绍 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息，包括产品模型的服务、属性、命令等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products/{product_id} 表1 路径参数 参数
户自己购买ECS服务器、购买ELB负载均衡、进行容器化等操作和费用。 当前只有IoTDA企业版支持托管部署，使用托管部署方案后，资源费用包含在IoTDA企业版内客户不用单独为部署资源付费。IoTDA标准版可以参考非托管部署方案进行部署和运维，产生的费用参考ECS服务器或者云容器实例CCI的费用说明。
设备的注册信息。若设置为“0”，则表示平台不会删除该设备的注册信息（建议填写为“0”）。 注意：该参数只对直连设备生效。 表5 TagV5DTO 参数 参数类型 描述 tag_key String 参数说明：标签键，在同一资源下标签键唯一。绑定资源时，如果设置的键已存在，则将覆盖
Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。
选择左侧导航栏的“用户组”，单击对应用户组进入用户组详情。 单击“授权记录“页签，单击“授权“按钮。 进入“授权--选择策略“页面，勾选步骤1中创建的策略，单击”下一步” 在”授权--设置最小授权范围”页面，选择”所有资源”，单击”确定”，完成授权。 方法2：为IAM用户所在的用户组授予Security
所有设备”，单击“文件上传”页签。 单击“服务授权”，在新弹出的页面中单击“同意授权”。 图2 文件上传-授权 注：如用户仅授权过设备接入服务访问对象存储服务的权限，可在控制台选择“设备 > 所有设备”，单击“文件上传”页签，然后单击“KMS服务授权”按钮。授权设备接入服务访问密钥管理服务的权限。
创建规则动作 功能介绍 应用服务器可调用此接口在物联网平台创建一条规则动作。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/routing-rule/actions 表1 路径参数 参数 是否必选 参数类型 描述 project_id
查询设备消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages
冻结设备 功能介绍 应用服务器可调用此接口冻结设备，设备冻结后不能再连接上线，可以通过解冻设备接口解除设备冻结。注意，当前仅支持冻结与平台直连的设备。该接口仅支持冻结单个设备，如需批量冻结设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/i
TagV5DTO 参数 参数类型 描述 tag_key String 参数说明：标签键，在同一资源下标签键唯一。绑定资源时，如果设置的键已存在，则将覆盖之前的标签值。如果设置的键值不存在，则新增标签。 取值范围：长度不超过64，只允许中文、字母、数字、以及_.-等字符的组合。 tag_value
物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备接入服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量。 示例场景 本示例为设备自带的温度传感器上报的温度大于80度时，平台自动下发命令关闭设备。
连接成功。 连接成功。 0x01 请求拒绝，协议版本错误。 服务器不支持客户端请求MQTT协议版本。 0x02 请求拒绝，无效的客户端标识符。 clientId不符合格式要求或者心跳时间间隔不满足平台要求。 0x03 请求拒绝，服务器不可用。 平台服务不可用。 0x04 请求拒绝，用户名或密码错误。
平台消息下发：用于平台下发自定义格式的数据给设备。 平台设置设备属性：设备的产品模型中定义了平台可向设备设置的属性，应用服务器可通过属性设置的方式修改指定设备的属性值。 平台查询设备属性：应用服务器通过属性查询的方式，实时查询指定设备的属性数据。 平台命令下发：应用服务器按产品模型中定义的命令格式下发控制命令给设备。
当规则引擎将消息转发至第三方应用服务器时，若该服务器故障导致消息无法及时处理，IoT物联网平台将会积压数据。考虑到用户对数据实时性的要求，我们支持清理积压在转发通道中的数据，以确保数据的及时处理和传输。 例如：当定时上报用户使用量的水表将数据发送至目标服务器时，由于服务器出现故障导致数据积压
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。该接口仅支持删除单个设备，如需批量删除设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
