All Products
Search
Document Center

DeleteVideo

Last Updated: Mar 04, 2019

Description

You can call this operation to delete one or more videos, including their source files, transcoded media stream files, and thumbnail snapshots.

This operation physically deletes videos. Deleted videos cannot be recovered. Exercise caution when calling this operation.

Request parameters

NameTypeRequiredDescription
ActionStringYesThe operation that you want to perform. Set the value to DeleteVideo.
VideoIdsStringYesThe list of video IDs.
  • Separate multiple video IDs with a comma (,).
  • You can enter a maximum of 10 video IDs.

Response parameters

NameTypeDescription
RequestId String The GUID generated by Alibaba Cloud for the request.

Examples

Sample requests

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=DeleteVideo&VideoIds=93ab850b4f6f44eab54b6e91d24d81d4,73ab850b4f6f44eab45b6e91d24d81d5&Format=JSON&<Common request parameters>

Note: For more information about common request parameters, see Common parameters.

Sample responses

JSON format

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58"
  3. }

Error codes

The following table lists the error codes that this operation can return. For more information, see Error codes.

Error codeError messageHTTP status codeDescription
VideoIdsExceededMaxThe VideoIds exceeded maximum.400The error message returned when the list of video IDs exceeds the maximum length.
InvalidVideo.NotFoundThe video does not exist. 404The error message returned when the specified video does not exist.
DeleteVideoFailedDeleting video has failed due to some unknown error.503 The error message returned when the system failed to delete the video. Try again later.