Deletes uploaded images and video snapshots that are automatically captured.
Operation description
- After you call this operation to delete an image, the source file is permanently deleted and cannot be recovered. If some images are cached on Alibaba Cloud CDN points of presence (POPs), the image URLs do not immediately become invalid.
- You can call this operation to delete uploaded images and video snapshots.
QPS limits
You can call this operation up to 50 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits on API operations in ApsaraVideo VOD.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
DeleteImageType | string | Yes | The method that is used to delete images. Valid values:
| VideoId |
ImageURLs | string | No | The URL of the image. You can obtain the value of ImageURL from the response to the CreateUploadImage operation. You can specify multiple URLs. Separate multiple URLs with commas (,). Note
This parameter is required only if you set DeleteImageType to ImageURL.
| https://example.aliyundoc.com/image/default/41AE7ADABBE*****.png |
ImageIds | string | No | The ID of the image file. You can specify multiple image IDs. Separate multiple IDs with commas (,). You can use one of the following methods to obtain the image ID:
Note
This parameter is required only if you set DeleteImageType to ImageId.
| bbc65bba53fed90de118a7849****,594228cdd14b4d069fc17a8c4a**** |
VideoId | string | No | The ID of the video file. You can use one of the following methods to obtain the video ID:
Note
This parameter is required only if you set DeleteImageType to VideoId.
| eb1861d2c9a8842340e989dd56**** |
ImageType | string | No | The type of images that you want to delete. The images are associated with the video. This parameter is required only if you set DeleteImageType to VideoId. Valid values:
| All |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****"
}
Error codes
For a list of error codes, visit the Service error codes.