All Products
Search
Document Center

GetURLUploadInfos

Last Updated: Jul 11, 2019

Description

You can call this operation to obtain the information about one or more upload jobs based on the returned job IDs or the URLs of the mezzanine files. The information includes the status, user data, creation time, and completion time of each upload job. If an upload job fails, the error code and error information appear. If an upload job succeeds, the corresponding video ID appears.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform. Set this parameter to GetURLUploadInfos.
JobIds String No The list of job IDs. Separate multiple job IDs with commas (,). You can enter a maximum of 10 job IDs.
UploadURLs String No The list of URLs of video mezzanine files. You must encode the URLs. Separate multiple URLs with commas (,). You can enter a maximum of 10 URLs. If you have uploaded the same video from a single URL for multiple times, we recommend that you only enter this URL for query. A maximum of 100 entries can be returned.

You must set either the JobIds or UploadURLs parameter. If you set both the parameters, only the value of the JobIds parameter takes effect.

Response parameters

Name Type Description
RequestId String The ID of the request.
URLUploadInfoList URLUploadInfo[] The URL upload information list.
NonExists String[] The list of job IDs or upload URLs that were not found.

API examples

Sample request

http://vod.cn-shanghai.aliyuncs.com/?Action=GetURLUploadInfos&JobIds=xxxxxxx,xxxxxxx&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",
      "URLUploadInfoList" :[{
                "JobId":"xxxxxxx",
                 "UploadURL" : "http://xxx",
                 "MediaId" : "xxxxx",
                 "Status": "SUCCESS",
                 "CreationTime" : "2019-01-01T01:01:01Z",
                 "CompleteTime": "2019-01-01T01:05:01Z",
                 "UserData": "xxxx"
             }, 
             {
                "JobId":"xxxxxxx",
                 "UploadURL" : "http://xxxx",
                 "Status": "PENDING",
                 "CreationTime" : "2019-01-01T01:01:01Z",
                 "CompleteTime": "2019-01-01T01:05:01Z",
               "UserData": "xxxx"
             }, 
             {
                "JobId":"xxxxxxx",
                 "UploadURL" : "http://xxxx",
                 "Status": "UPLOAD_FAIL",
                 "CreationTime" : "2019-01-01T01:01:01Z",
                 "CompleteTime": "2019-01-01T01:05:01Z",
                 "UserData": "xxxx",
                 "ErrorCode":"",
                 "ErrorMessage":""
             }, ...],
     "NonExists": ["XXXX1", "XXX2"]
}

Error codes

For more information about errors common to all operations, see common errors.