Deletes one or more videos at a time, including their mezzanine files, transcoded stream files, and thumbnail snapshots.
Note
- This operation physically deletes videos. Deleted videos cannot be recovered. Exercise caution when you call this operation.
- You can call this operation to delete multiple videos at a time.
- When you delete a video, its source file, transcoded stream file, and thumbnail screenshot are also deleted. However, the Alibaba Cloud Content Delivery Network (CDN) cache is not refreshed simultaneously. You can use the refresh feature in the ApsaraVideo VOD console to clear garbage data on CDN nodes. For more information, see Refresh and prefetch.
QPS limit
You can call this operation up to 30 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DeleteVideo |
The operation that you want to perform. Set the value to DeleteVideo. |
VideoIds | String | Yes | e44ebf1147hdsa2d2adbea8b****,e44ebf11oj984adbea8****,73ab850b4f6f4b6e91d24d81d54**** |
The list of video IDs. Separate multiple IDs with commas (,). A maximum of 20 IDs can be specified. You can obtain a video ID in one of the following ways:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | E4EBD2BF-5EB0-4476-8829-9D94E1B1**** |
The ID of the request. |
ForbiddenVideoIds | Array of String | 73ab850b4f6f4b6e91d24d81d54**** |
The IDs of the videos that cannot be deleted. Note Generally, videos cannot be deleted if you do not have the required permissions.
|
NonExistVideoIds | Array of String | e44ebf1147hdsa2d2adbea8b**** |
The IDs of the videos that do not exist. Note If the list of videos to be deleted contains one or more videos that do not exist,
the IDs of these non-existing videos are returned. If none of the videos in the list
exists, a 404 error is returned.
|
Examples
Sample requests
http(s)://vod.cn-shanghai.aliyuncs.com/?Action=DeleteVideo
&VideoIds=e44ebf1147hdsa2d2adbea8b****,e44ebf11oj984adbea8****,73ab850b4f6f4b6e91d24d81d54****
&<Common request parameters>
Sample responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DeleteVideoResponse>
<RequestId>E4EBD2BF-5EB0-4476-8829-9D94E1B1****</RequestId>
<ForbiddenVideoIds>73ab850b4f6f4b6e91d24d81d54****</ForbiddenVideoIds>
<NonExistVideoIds>e44ebf1147hdsa2d2adbea8b****</NonExistVideoIds>
</DeleteVideoResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "E4EBD2BF-5EB0-4476-8829-9D94E1B1****",
"ForbiddenVideoIds" : [ "73ab850b4f6f4b6e91d24d81d54****" ],
"NonExistVideoIds" : [ "e44ebf1147hdsa2d2adbea8b****" ]
}
Error codes
For a list of error codes, visit the API Error Center.
Common errors
The following table describes the common errors that this operation can return.
Error code |
Error message |
HTTP status code |
Description |
---|---|---|---|
VideoIdsExceededMax |
The VideoIds exceeded maximum. |
400 |
The error message returned because the list of video IDs exceeds the maximum length. |
InvalidVideo.NotFound |
The video does not exist. |
404 |
The error message returned because the video does not exist. |
DeleteVideoFailed |
Deleting video has failed due to some unknown error. |
503 |
The error message returned because the system failed to delete the video. Try again later. |
Sample code of SDKs for various languages
We recommend that you use a server-side SDK to call this operation. For more information about the sample code that is used to call this operation in various languages, see the following topics: