Deletes one or more videos at a time, including their mezzanine files, transcoded stream files, and thumbnail snapshots.
Operation description
- 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.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
VideoIds | string | Yes | 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:
| e44ebf1147hdsa2d2adbea8b****,e44ebf11oj984adbea8****,73ab850b4f6f4b6e91d24d81d54**** |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B1****",
"ForbiddenVideoIds": [
"73ab850b4f6f4b6e91d24d81d54****"
],
"NonExistVideoIds": [
"e44ebf1147hdsa2d2adbea8b****"
]
}
Error codes
For a list of error codes, visit the Service error codes.
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. |