云服务器内容精选

  • 参数说明 参数 必选/可选 类型 位置 描述 accessToken 必选 String header 如果调用了定时刷新token接口,此参数值可以填写null,否则要填写鉴权接口获取的accessToken。 qtdInDTO 必选 QueryTaskDetailsInDTO query 详细参见QueryTaskDetailsInDTO结构体的描述。 QueryTaskDetailsInDTO结构体: 参数 必选/可选 类型 位置 描述 appId 可选 String query 如果是本应用的设备,此参数值可以填写null,否则填写授权应用的appId。 taskId 必选 String query 批量任务的ID。 status 可选 String query 任务的详情状态,Pending/WaitResult/Success/Fail/Timeout。 deviceId 可选 String query 设备Id,查询批量命令任务时使用。 commandId 可选 String query 命令Id,查询批量命令任务时使用。 pageNo 可选 Integer query 分页查询参数。 值为空时,查询内容不分页。 值为大于等于0的整数时,分页查询。 值为0时查询第一页。 pageSize 可选 Integer query 分页查询参数,取值大于等于1的整数,缺省值:1。
  • 错误码 Http状态码 错误码 错误描述 说明 400 100022 The input is invalid 输入参数无效。 处理建议:请检查接口调用请求中携带参数的合法性。 403 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径(url)中传入的appId是否有误。 403 100217 The application hasn't been authorized 应用未被授权。 处理建议:若非应用授权场景,请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁,超过流控值(默认值是100次/60s)。 处理建议:联系 物联网平台 维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议:请检查接口请求中所携带的accessToken是否有误。 404 105005 The batchTask is not existed. 批量任务不存在。 处理建议:请检查接口请求中的taskId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径(url)中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。
  • 请求参数 参数 必选/可选 类型 位置 描述 app_key 必选 String header 访问物联网平台的应用ID,在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息,值为“Bearer {accessToken}”,其中{accessToken}为调用鉴权接口返回的accessToken。 appId 可选 String query 批量任务所属的应用ID,当查询授权应用下的批量任务时才需要填写。 taskId 必选 String query 批量任务的ID。 status 可选 String query 任务的详情状态,Pending/WaitResult/Success/Fail/Timeout。 deviceId 可选 String query 设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 commandId 可选 String query 设备命令ID,用于唯一标识一条命令,在下发设备命令时由物联网平台分配获得。 pageNo 可选 Integer query 分页查询参数,查询结果分页显示时指定要查看的页信息,默认值0,查询第一页,取值范围为大于等于0的整数。 pageSize 可选 Integer query 分页查询参数,查询结果分页显示时每页显示的记录数,默认值为25,取值范围为1-250的整数。
  • 请求示例 GET https://{host}:{port}/iocm/app/batchtask/v1.1.0/taskDetails?appId=********&taskId=******&status=******&pageNo=******&pageSize=******Content-Type: application/jsonapp_key: ******Authorization: Bearer ******
  • 正常响应示例 Status Code: 200 OKContent-Type: application/json{ "totalCount": 1, "pageNo": 0, "pageSize": 1, "taskDetails": [ { "status": "WaitResult", "output": "{\"requestId\":\"*****\",\"commandResult\":null}", "error": null, "param": { "deviceId": "*******", "commandId": "*******" } }, { "status": "WaitResult", "output": "{\"requestId\":\"******\",\"commandResult\":null}", "error": null, "param": { "deviceId": "******", "commandId": "*******" } } ]}
  • 错误码 Http状态码 错误码 错误描述 说明 400 100022 The input is invalid 输入参数无效。 处理建议:请检查接口调用请求中携带参数的合法性。 403 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径(url)中传入的appId是否有误。 403 100217 The application hasn't been authorized 应用未被授权。 处理建议:若非应用授权场景,请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁,超过流控值(默认值是100次/60s)。 处理建议:联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议:请检查接口请求中所携带的accessToken是否有误。 404 105005 The batchTask is not existed. 批量任务不存在。 处理建议:请检查接口请求中的taskId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径(url)中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。