All Products
Search
Document Center

RefreshUploadVideo

Last Updated: Jul 11, 2019

Description

You can call this operation to obtain a new upload credential if the upload of a video file times out.

This operation can also be used to upload and overwrite the mezzanine file of a video or audio. That is, you can obtain the mezzanine file upload URL and upload the mezzanine file again without changing the video or audio ID. However, this operation may automatically trigger transcoding and snapshot jobs. For more information, see Upload URL and credential.

Request parameters


Name Type Required Description
Action String Yes The operation that you want to perform. Set this parameter to RefreshUploadVideo.
VideoId String Yes The ID of the video.

Response parameters

Name Type Description
RequestId String The ID of the request.
UploadAuth String The upload credential.
UploadAddress String The upload URL.

API examples

Sample request

http://vod.cn-shanghai.aliyuncs.com/?Action=RefreshUploadVideo&VideoId=93ab850b4f6f44eab54b6e91d24d81d4&Format=JSON&<Common request parameters>

Note: For more information about common request parameters, see Common parameters.

Sample response

JSON format

{
"RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
"UploadAuth": "eyJTZWN1cml0eVRva2VuIjoiQ0FJU3p3TjFxNkZ0NUIyeW",
"UploadAddress": "eyJTZW1451QIjoiQ0FJU3p3TjFxNkZ0NUIyeW"

} 

Error codes

This operation also returns common errors. For more information about errors common to all operations, see common errors.


Error code Error message HTTP status code Description
InvalidVideo.Damaged The video has been Damaged. 400 The error message returned because an error occurred during video creation or the specified video has been damaged.
InvalidVideo.NotFound The video not exist. 404 The error message returned because the specified video does not exist.

SDK examples

We recommend that you use a server SDK to call this operation. For more information about the sample code used to call this operation in various languages, see the following topics: