调用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时必传。
VideoId String eb1861d2c9a8*****842340e989dd56

视频ID。DeleteImageType=VideoId时必传。

ImageType String All

图片类型。DeleteImageType=VideoId时必传。

取值:

  • CoverSnapshot:封面截图。
  • NormalSnapshot:SubmitSnapshotJob接口发起的普通截图 。
  • SpriteSnapshot:SubmitSnapshotJob接口发起的雪碧截图。
  • SpriteOriginSnapshot:组成雪碧图的原始小图。
  • All(以上多种类型的图片):非All时支持多个类型英文逗号分隔传入。

返回数据

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

请求ID。

说明 下述请求示例中的“公共请求参数”详情,参见公共参数说明文档

示例

请求示例

http(s)://[Endpoint]/?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各语言调用的示例代码,请参考如下: