调用DeleteMultipartUpload删除上传中产生的碎片文件。

使用说明

  • 使用分片上传时,若上传失败则可能会产生碎片文件,一般7天后会自动清除。在上传完成或失败后,可调用本接口手动清除碎片文件。
  • 调用本接口不会删除原始文件和转码后的文件,只会删除上传过程中产生的碎片文件。
  • 调用删除完整视频接口,会删除包含碎片文件等在内的完整视频文件。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

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

系统规定参数。取值:DeleteMultipartUpload

MediaId String 61ccbdb06fa3012be4d8083f6****

媒体ID,即音/视频ID(VideoId)。可通过以下方式获取:

  • 通过控制台上传的音/视频,可登录点播控制台,选择媒资库 > 音/视频查看音/视频ID。
  • 通过获取视频上传地址和凭证接口获取上传地址和凭证时,音/视频ID为返回参数VideoId的值。
  • 音/视频上传后,可通过搜索媒体信息接口查询音/视频ID,为请求后返回参数VideoId的值。
MediaType String video

媒体类型。取固定值:video(音/视频)。

返回数据

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

请求ID。

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=DeleteMultipartUpload
&MediaId=61ccbdb06fa3012be4d8083f6****
&MediaType=video
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteMultipartUploadResponse>
    <RequestId>25818875-5F78-4AF6-D7393642CA58****</RequestId>
</DeleteMultipartUploadResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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

接口错误码

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

错误代码

错误信息

HTTP 状态码

说明

InvalidParameter

The specified parameter “MediaType” is invalid.

400

MediaType参数无效。

InvalidMultipartUpload.NotFound

The multipart upload not exist.

400

碎片文件不存在。

InvalidVideo.NotFound

The video does not exist.

400

视频不存在。

InvalidFile.NotFound

The file does not exist.

400

视频文件不存在。

InvalidStorage.NotFound

can’t find storage.

400

存储不存在。

AccessDenied

Access denied by authorizer’s policy.

400

自有bucket未授权点播服务访问,无权限执行该操作。