调用 DeleteMaterial 接口通过指定 Mid（素材 ID）删除素材文件。

使用说明 #

此接口调用成功后，系统将生成异步删除的任务。您可以配置素材文件删除完成事件通知。开启后每个 Mid 删除完成您将收到回调消息。配置方法详见事件通知概览。

请求说明 #

请求方式：GET

请求地址：https://vod.volcengineapi.com?Action=DeleteMaterial&Version=2023-07-01

请求参数 #

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

返回参数 #

本接口无特有的返回参数。具体请见公共返回参数。

请求示例 #

以下为请求结构示意。请将 SpaceName 和 Mid 替换为实际值，并根据签名计算生成鉴权请求头。示例中的鉴权信息为占位内容，不能直接用于调用。本接口通过查询参数传入参数，无需请求 Body。

GET /?Action=DeleteMaterial&Version=2023-07-01&SpaceName=test&Mid=your_material_id HTTP/1.1
Host: vod.volcengineapi.com
X-Date: <请求时间>
Authorization: <按签名规则生成的鉴权信息>

返回示例 #

以下为依据公共返回参数构造的成功响应示意，并非真实调用记录。接口调用成功表示异步删除任务已提交，素材是否删除完成请以素材文件删除完成事件为准。

{
  "ResponseMetadata": {
    "RequestId": "example-request-id",
    "Action": "DeleteMaterial",
    "Version": "2023-07-01",
    "Service": "vod",
    "Region": "cn-north-1"
  }
}

错误码 #

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

SDK #

服务端 SDK #

视频点播为 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API。此 API 各语言调用的示例代码，请参考如下：

• Java
• Python
• PHP
• Go
• Node.js