DeleteTask - 删除工程化剪辑任务记录--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

DeleteTask - 删除工程化剪辑任务记录

最近更新时间：2025.10.24 21:15:23首次发布时间：2025.10.24 19:49:14

调用 DeleteTask 接口通过 TaskId 删除一个已提交的工程化剪辑任务的记录。

使用说明

当您通过 SubmitEditTaskAsync 接口提交基于剪辑工程的剪辑任务后，系统会创建一条任务记录，您可以通过 GetTaskList 接口查询到这些记录。本接口可以删除这些任务记录，使其不再出现在任务列表中。

请求说明

请求方式：GET
请求地址：https://vod.volcengineapi.com?Action=DeleteTask&Version=2018-01-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`DeleteTask`	接口名称。当前 API 的名称为 `DeleteTask`。
Version	String	是	`2018-01-01`	接口版本。当前 API 的版本为 `2018-01-01`。
TaskId	String	是	`e070c747a0b***7976dd2aa5903xxxx`	剪辑任务 ID。您可以通过调用 `SubmitEditTaskAsync` 接口或 `GetTaskList` 接口获取此 ID。
Type	String	是	`1`	剪辑任务类型，当前仅支持取值为 `1`。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
Result	Integer	`1`	操作结果，`1` 表示成功。

请求示例

GET https://vod.volcengineapi.com?Action=DeleteTask&Version=2018-01-01&TaskId=e070c747a0b***7976dd2aa5903xxxx&Type=1

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "DeleteTask",
    "Version": "2018-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": 1
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。