添加属性设置任务 - 阿里云物联网平台

如果您需要同时设置多个设备的属性值，可以使用物联网平台的设备批量属性设置任务。本文介绍该任务的创建方法、运行中Topic及其数据格式的说明，查看状态的具体操作。

前提条件

创建设备批量属性设置任务。

在创建任务页面，单击以下参数名称右侧的帮助图标

，根据页面提示，配置任务和作业。

任务配置

参数	说明
任务名称	输入符合规则的任务名称。可自定义。
任务类型	选择类型：设备批量属性设置任务。
任务描述	输入该任务的用途等信息，便于您区分不同的任务。
目标设备、产品或分组	从设备、产品或分组维度选择可执行任务的设备。重要从分组维度选择设备时，不支持选择动态分组。
下发给设备的任务执行规则	上传规则文件。仅支持`.json`格式文件，文件大小不能超过64 KB。您可单击下载模板，获取规则文件模板。例如设备所属产品下的物模型属性温度，标识符为temperature），数据类型为double，代码示例如下： `{ "params": { "temperature": 30.5 } }` params：属性设置参数。其下可包含多个属性。 temperature、30.5：属性标识符及对应值。可在物联网平台控制台，设备所属产品的功能定义中查看属性标识符。如果是自定义（非默认）模块`testFb`下属性`temperature`，则参数为`"testFb:temperature":30.5`。

作业配置

参数	说明
作业执行速率配置	根据您的业务需要，设置每分钟作业推送数量。必选配置。
作业执行的超时配置	仅对自定义任务生效。此处无需配置。
作业开始调度时间	可选配置。从当前设置操作的时间，开始计算时间。设备任务创建成功后，先初始化，直至到达调度时间，才会开始调度执行。

任务创建完成后，物联网平台通过调用SetDeviceProperty或SetDevicesProperty接口，下发设置属性指令到设备，然后设备向物联网平台返回响应结果。

数据格式（下行）	请求和响应Topic
透传/自定义	请求Topic：`/sys/${productKey}/${deviceName}/thing/model/down_raw` 响应Topic：`/sys/${productKey}/${deviceName}/thing/model/down_raw_reply`
Alink JSON	请求Topic：`/sys/${productKey}/${deviceName}/thing/service/property/set` 响应Topic：`/sys/${productKey}/${deviceName}/thing/service/property/set_reply`

消息格式如下：

{
    "id": "123",
    "version": "1.0",
    "params": {
        "temperature": "30.5"
    },
    "method": "thing.service.property.set"
}

其中，params数据是任务规则文件的params数据。

设置设备属性的Alink协议，请参见设置设备属性。

在物联网平台对应实例下的监控运维 > 任务管理页面，查看已创建任务及当前状态。

重要状态为已超时的任务，不可再被调度执行。

从任务创建完成开始计时，如果任务下作业未在7天内全部执行完成，任务状态显示为已超时。

您可根据实际场景需要，执行以下操作：

单击目标任务对应的查看，在任务详情页面，查看任务信息和作业执行统计。

功能页签	说明
任务信息	您可以查看任务信息，修改任务描述和作业配置，下载设备任务文件。
作业概览	您可以查看任务下各状态的作业统计。您可以单击目标设备的查看，在设备详情页面：单击任务页签，查看该设备下的所有任务列表。单击日志服务的前往查看，在云端运行日志页签的搜索栏，选择业务类型为云到设备消息，查看设备任务相关日志。如果作业未执行成功，单击执行详情，可查看失败原因。如果作业执行已超时或失败，单击已超时或失败的状态按钮，可查看对应状态的作业列表。您可以单击列表上方的重新执行，重新执行当前任务下所有已超时和失败的作业。