创建多个设备

最近更新时间:2019-04-30 15:14:03

1. 接口描述

本接口(CreateMultiDevice)用于批量创建物联云设备。

接口请求域名:iotcloud.api.qcloud.com

  • 同一开发商账户下设备名称需保持唯一
  • 创建设备时,需要与一个产品绑定,这样便于管理
  • 批量创建设备接口采用异步任务的方式执行

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数 页面。

参数名称 必选 类型 描述
productID String 产品 ID。创建产品时腾讯云为用户分配全局唯一的 ID
listDeviceName Array of String 批量创建的设备名数组,单次最多创建 100 个设备。命名规则:[a-zA-Z0-9:_-]{1,48}

3. 输出参数

参数名称 类型 描述
code Int 公共错误码,0 表示成功,其他值表示失败,详见 公共错误码 页面
message String 模块错误信息描述,格式为 "(模块错误码)模块错误信息", 详见本页面的 模块错误码
taskID String 任务ID,腾讯云生成全局唯一的任务 ID,有效期一个月,一个月之后任务失效。可以调用获取创建多设备任务状态接口获取该任务的执行状态,当状态为成功时,可以调用获取创建多设备任务结果接口获取该任务的结果

4. 示例

输入


  https://iotcloud.api.qcloud.com/v2/index.php?Action=CreateMultiDevice
  &productID=ABCDE12345
  &listDeviceName.0=apple
  &listDeviceName.1=banana
  &<公共请求参数>

输出

{       
    "message": "",
    "codeDesc": "Success",
    "code": 0,
    "taskID":"abcdedf123456789"
}

5. 模块错误码

模块错误码 描述
2008 产品不存在,请检查ProductID
2100 内部服务错误
2101 请求参数非法