删除媒资的部分文件
更新时间:2024-12-12
本接口用于删除媒资的部分输出文件,可以指定媒资的视频文件下的转码视频、抽帧文件、字幕文件、审核/分析信息等。
如果删除的是被分发的文件,也会刷新CDN全网节点的分发缓存,生效时间约5~10分钟。
请求结构
POST /v2/medias/{mediaId}/output/delete HTTP/1.1
connection: keep-alive
host: vod.bj.baidubce.com
content-type: application/json
x-bce-request-id: <bce-request-id>
x-bce-date: <utc-date-string>
authorization: <bce-authorization-string>
{
// 请求参数
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
mediaId | string | 是 | Path参数 | 媒资ID |
transcodeOutputIds | string[] | 否 | RequestBody参数 | 转码输出ID列表 |
thumbnailOutputIds | string[] | 否 | RequestBody参数 | 抽帧输出ID列表 |
subtitleOutputIds | string[] | 否 | RequestBody参数 | 字幕输出ID列表 |
analysisOutputIds | string[] | 否 | RequestBody参数 | 分析输出ID列表 |
regulationOutputIds | string[] | 否 | RequestBody参数 | 审核输出ID列表 |
返回头域
除公共头域,无其它特殊头域。
返回参数
无。
示例
删除指定媒资的1080P转码输出文件
ejisxn9bmajvi36kxwnz
是媒资mda-ek1knpprazeyv1gn
的1080P转码输出文件的模版ID。
请求内容
POST /v2/medias/mda-ek1knpprazeyv1gn/output/delete HTTP/1.1
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
content-type: application/json
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
x-bce-date: 2024-03-24T13:08:44Z
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"transcodeOutputIds": [
"ejisxn9bmajvi36kxwnz"
]
}
返回内容
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
Cache-Control: no-cache
Date: Tue, 24 Mar 2024 13:08:44 GMT
Content-Type: application/json;charset=UTF-8
错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
错误码 | 错误信息 | HTTP状态码 | 描述 |
---|---|---|---|
MediaNotFound | Media not found with mda-xxx | 404 Not Found | 没有找到对应的媒资 |