DeleteMultipartUpload -

Usage notes

In a multipart upload, fragments may be generated if the upload fails. In most cases, the fragments are automatically deleted after seven days. You can call this operation to delete the generated fragments after the upload is successful or fails.
This operation does not delete the source file or transcoded file, but deletes only the fragments generated during the upload.
If you call the DeleteVideo operation, the entire video file is deleted, including the generated fragments.

QPS limit

You can call this operation up to 10 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limits on API operations in ApsaraVideo VOD.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	DeleteMultipartUpload	The operation that you want to perform. Set the value to DeleteMultipartUpload.
MediaId	String	Yes	61ccbdb06fa3012be4d8083f6****	The ID of the media file, namely, the audio or video ID. You can use one of the following methods to obtain the audio or video ID: Log on to the ApsaraVideo VOD console. In the left-side navigation pane, choose Media Files > Audio/Video. On the Video and Audio page, you can view the audio or video ID. Use this method if the audio or video file is uploaded by using the ApsaraVideo VOD console. View the value of the VideoId parameter returned by the CreateUploadVideo operation that you called to obtain an upload URL and credential. View the value of the VideoId parameter returned by the SearchMedia operation that you called to query an audio or video ID after the audio or video file is uploaded.
MediaType	String	Yes	video	The type of the media file. Set the value to video, which indicates audio and video files.

Response parameters


Parameter	Type	Example	Description
RequestId	String	25818875-5F78-4AF6-D7393642CA58****	The ID of the request.

Examples

Sample requests

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=DeleteMultipartUpload
&MediaId=61ccbdb06fa3012be4d8083f6****
&MediaType=video
&<Common request parameters>

Sample success responses

XML format

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

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

JSON format

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

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

Error codes

For a list of error codes, visit the API Error Center.

Common errors

The following table describes the common errors that this operation can return.


Error code	Error message	HTTP status code	Description
InvalidParameter	The specified parameter "MediaType" is invalid.	400	The error message returned because the MediaType parameter is invalid.
InvalidMultipartUpload.NotFound	The multipart upload not exist.	400	The error message returned because the fragments do not exist.
InvalidVideo.NotFound	The video does not exist.	400	The error message returned because the video does not exist.
InvalidFile.NotFound	The file does not exist.	400	The error message returned because the video file does not exist.
InvalidStorage.NotFound	can't find storage.	400	The error message returned because the specified storage location does not exist.
AccessDenied	Access denied by authorizer's policy.	400	The error message returned because ApsaraVideo VOD is not authorized to access the self-managed Object Storage Service (OSS) bucket and you are not authorized to perform the operation.