调用DeleteImage删除用户上传的图片及视频自动截图。

说明 真正删除源文件,且不可逆,一旦删除,图片无法找回。某些情况存在CDN缓存,图片URL不会立即失效。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DeleteImage

系统规定参数。取值:DeleteImage

DeleteImageType String VideoId

图片删除操作类型。取值:

  • ImageURL:根据图片URL删除指定图片。
  • ImageId:根据图片ID删除指定图片。
  • VideoId:根据视频ID删除其关联图片。
ImageURLs String https://al*****.cn/image/default/41AE7ADABBE*****.png

图片URL。

  • DeleteImageType取值为ImageURL时,本参数才可用且必须传入。
  • URL编码,多个用英文逗号(,)分隔。
  • 避免存在特殊字符导致图片无法删除成功,需要URL编码后再做逗号拼接。
ImageIds String bbc65bba53f*****ed90de118a7849,594228cdd14b4d*****069fc17a8c4a

图片ID。

  • DeleteImageType取值为ImageId时,本参数才可用且必须传入。
  • 多个图片ID,请使用英文逗号(,)分隔。
VideoId String eb1861d2c9a8*****842340e989dd56

视频ID。当DeleteImageType取值为VideoId时,本参数才可用且必须传入。

ImageType String All

图片类型。当DeleteImageType取值为VideoId时,本参数才可用且必须传入。取值:

  • CoverSnapshot:封面截图。
  • NormalSnapshot:普通截图。
  • SpriteSnapshot:雪碧截图。
  • SpriteOriginSnapshot:雪碧图原始图。
  • All(以上多种类型的图片):非All时支持多个类型,使用英文逗号(,)分隔传入。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4A*****F6-D7393642CA58

请求ID。

示例

请求示例

https://vod.aliyuncs.com/?Action=DeleteImage
&DeleteImageType=VideoId
&<公共请求参数>

正常返回示例

XML 格式

<DeleteImageResponse>
      <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
</DeleteImageResponse>

JSON 格式

{
    "RequestId": "25818875-5F78-4A*****F6-D7393642CA58"
}

错误码

访问错误中心查看更多错误码。

接口错误码

下表列举了本接口特有的错误码。

错误代码

错误信息

HTTP 状态码

说明

NoSuchResource

The specified resource does not exist.

404

图片信息不存在。

SDK示例

建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见: