CreateDeviceDistributeJob_物联网平台_API文档

使用说明

您可参考以下步骤，完成设备分发。

1. 调用本接口发起设备分发任务（异步调用），获取返回参数 JobId。

2. 将上一步的返回参数 JobId 作为请求参数，重复调用接口 QueryDeviceDistributeJob ，查看返回参数 Status。

   说明 您需根据接口的 QPS 限制，控制重复调用接口的频率。

   Status 值如下，表示分发任务已处于最终态：

   • 2：设备分发任务正常执行完成。此时，不代表所有设备分发成功，每个设备的具体分发结果，请执行下一步获取。
   • 3：分发异常中断。处理异常流后，可重新发起设备分发任务。

3. 将第一步的返回参数 JobId 作为请求参数，调用接口 QueryDeviceDistributeDetail ，获取返回参数 File，即分发结果的文件 URL。

   说明 文件 URL 的有效期为 10 分钟。

4. 通过文件 URL 获取分发结果详情，其中每个设备对应一个分发结果 Code，当 Code 为 200 时，表示该设备分发成功。

   如果设备分发失败，您可按照以上操作，重新进行设备分发。

限制说明

• 调用云服务的接入地址 Endpoint 仅支持华东 2（上海），即iot.cn-shanghai.aliyuncs.com。

• 不支持调用本接口创建跨账号的分发任务。

• 单个阿里云账号下，产品分发和设备分发的任务总数不超过 10 个。创建产品分发任务，请参见 CreateProductDistributeJob 。

• 单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为 2。

  说明 RAM 用户共享阿里云账号配额。