V2.1 Delete OTA Job


删除批量的固件 OTA 升级任务。

该 API 支持在 EnOS 2.2.0 及以上环境中使用。

操作权限


确保已获取调用该 API 的权限。更多信息，参见 获取 API 调用权限。

请求格式

POST https://{apigw-address}/connect-service/v2.1/ota-jobs?action=delete

请求参数（URI）

名称

位置（Path/Query）

必需/可选

数据类型

描述

orgId

Query

必需

String

OTA job 所属的 OU ID。如何获取orgId信息>>

jobId

Query

必需

String

需要删除的 OTA job ID。前往 EnOS 应用门户 > 开发者控制台，在 运行监控 > OTA 升级 中的 任务 ID 列查看 Job ID。

错误码

代码

错误信息

描述

24404

Job not found

找不到 OTA job。

24618

Not allowed to delete running job

OTA job 仍在运行，无法删除。

示例

请求示例

url: https://{apigw-address}/connect-service/v2.1/ota-jobs?action=delete&orgId=yourOrgId&jobId=yourJobId
method: POST

返回示例

{
    "code":0,
    "msg":"OK",
    "requestId":"dcf62008-7904-4560-9db6-6a9e3519c765",
    "data":null
}