调用DeleteVideo删除完整视频(包括其源文件、转码后的流文件、封面截图等),支持批量删除。
说明 此接口为物理删除视频,且无法恢复,请谨慎操作。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DeleteVideo |
系统规定参数。取值:DeleteVideo。 |
VideoIds | String | 是 | e44ebf114*****2d2adbea8bf5b5,e44ebf11*****adbea8bf55 |
视频ID列表。多个ID使用英文逗号(,)分隔。最多支持20个。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 25818875-5F78-4A*****F6-D7393642CA58 |
请求ID。 |
ForbiddenVideoIds | List | 73ab850b4f6f4*****b6e91d24d81d5 |
被禁止操作的视频ID列表。 说明 一般由于无权限导致。
|
NonExistVideoIds | List | 93ab850b4f6f*****4b6e91d24d81d4 |
不存在的视频ID列表。 |
示例
请求示例
https://vod.aliyuncs.com/?Action=DeleteVideo
&VideoIds=e44ebf114*****2d2adbea8bf5b5,e44ebf11*****adbea8bf55
&<公共请求参数>
正常返回示例
XML
格式
<DeleteVideoResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
<NonExistVideoIds>73ab850b4f6f4*****b6e91d24d81d5</NonExistVideoIds>
<UnRemoveableVideoIds>93ab850b4f6f*****4b6e91d24d81d4</UnRemoveableVideoIds>
</DeleteVideoResponse>
JSON
格式
{
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"NonExistVideoIds":"73ab850b4f6f4*****b6e91d24d81d5",
"ForbiddenVideoIds":"93ab850b4f6f*****4b6e91d24d81d4"
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 |
错误信息 |
HTTP 状态码 |
说明 |
---|---|---|---|
VideoIdsExceededMax |
The VideoIds exceeded maximum. |
400 |
视频ID列表超过最大长度。 |
InvalidVideo.NotFound |
The video does not exist. |
404 |
视频不存在。 |
DeleteVideoFailed |
Deleting video has failed due to some unknown error. |
503 |
删除视频失败,请稍后重试。 |
SDK示例
建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见:
在文档使用中是否遇到以下问题
更多建议
匿名提交