You need to enable JavaScript to run this app.
导航
根据文件路径删除媒体文件
最近更新时间:2024.08.23 16:14:03首次发布时间:2024.03.26 14:44:51

此接口用于 DirectUrl 模式下通过 FileName(文件路径)删除媒体文件。

使用说明

  • 删除 DirectUrl 模式下的文件后,对应的 Vid 元信息不会被删除。
  • 最多支持一次删除 1000 个文件。
  • 该接口仅处理单文件。如果是 HLS 或 DASH 格式的音视频,您调用该接口处理每个分片文件。

请求说明

  • 请求方式:POST
  • 请求地址:https://vod.volcengineapi.com?Action=DeleteMediaTosFile&Version=2022-12-01

调试

请求参数

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

Query

参数
类型
是否必选
示例值
描述
Action
String
DeleteMediaTosFile
接口名称。当前 API 的名称为 DeleteMediaTosFile
Version
String
2022-12-01
接口版本。当前 API 的版本为 2022-12-01

Body

参数
类型
是否必选
示例值
描述
SpaceName
String
testSpace

点播空间名称。可通过以下方式获取空间名称:

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。
FileNames
String
"["testFileName1","testFileName2"]"
文件路径。您可在通过点播控制台视频管理页面获取文件路径。

返回参数

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

参数
类型
示例值
描述
FailedFileNames
String[]
[]
删除失败的文件路径列表。

请求示例

POST https://vod.volcengineapi.com?Action=DeleteMediaTosFile&Version=2022-12-01
{
    "SpaceName": "testSpace",
    "FileNames": "[\"testFileName1\",\"testFileName2\"]"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604***100100232280022D31",
        "Action": "DeleteMediaTosFile",
        "Version": "2022-12-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": {
        "FailedFileNames": [
        ]
    }
}

错误码

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

SDK

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