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
}
SDK 示例¶
你可以在 Github 上获取接入服务的 SDK 示例：