调用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各语言调用的示例代码,请参见: