Queries the information about URL-based upload jobs.

Note You can query the information about a URL-based upload job by specifying the upload URL or the job ID returned when you upload media files. The information includes the status of the upload job, custom configurations, the time when the job was created, and the time when the job was complete. If the upload fails, you can view the error code and error message. If the upload is successful, you can obtain the video ID.

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 GetURLUploadInfos

The operation that you want to perform. Set the value to GetURLUploadInfos.

JobIds String No 86c192*****5fba0,7afb*****201e7fa,2cc49*****97378

The job IDs. You can obtain the job IDs in the response parameter PlayInfo of the GetPlayInfo operation.

Note Separate multiple IDs with commas (,). A maximum of 10 IDs can be specified.
UploadURLs String No http://****.mp4

The upload URLs of video mezzanine files. URL encoding is required. Separate multiple URLs with commas (,). A maximum of 10 URLs can be specified. If a video is uploaded multiple times, pass the URL of the video to this parameter only one time.

Note You must set one of the JobIds and the UploadURLs parameters. If you set both the JobIds and UploadURLs parameters, only the value of the JobIds parameter takes effect.

Response parameters

Parameter Type Example Description
NonExists List ["****1", "****2"]

The IDs or URLs that do not exist.

RequestId String 25818875-5F78-4A*****F6-D7393642CA58

The ID of the request.

URLUploadInfoList Array of UrlUploadJobInfoDTO

The information about URL-based upload jobs. For more information about the name and description of upload job parameters, see the "URLUploadInfo" section of the Basic data types topic.

CompleteTime String 2019-01-01T01:11:01Z

The time when the job was complete. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

CreationTime String 2019-01-01T01:01:01Z

The time when the job was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

ErrorCode String 200

The error code.

ErrorMessage String error_message

The error message.

FileSize String 24

The size of the file. Unit: byte.

JobId String 86c192*****5fba0

The ID of the job.

MediaId String 93ab850b4f6f*****54b6e91d24d81d4

The ID of the uploaded video.

Status String SUCCESS

The status of the URL-based upload job. For more information about the valid values and value description of the parameter, see the "Status" section of the Basic data types topic.

UploadURL String http://****.mp4

The upload URL.

Note A maximum of 100 URLs can be returned.
UserData String {"MessageCallback":"{"CallbackURL":"http://test.test.com"}", "Extend":"{"localId":"***", "test":"www"}"}

The custom configurations. The value is a JSON-formatted string. For more information, see the "UserData" section of the Request parameters topic.

Examples

Sample requests

https://vod.aliyuncs.com/?Action=GetURLUploadInfos
&<Common request parameters>

Sample success responses

XML format

<GetURLUploadInfosResponse>
  <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
  <URLUploadInfoList>
        <Status>SUCCESS</Status>
        <UploadURL>http://****.mp4</UploadURL>
        <MediaId>93ab850b4f6f*****54b6e91d24d81d4</MediaId>
        <UserData>{"MessageCallback":"{"CallbackURL":"http://test.test.com"}", "Extend":"{"localId":"***", "test":"www"}"}</UserData>
        <CreationTime>2019-01-01T01:01:01Z</CreationTime>
        <ErrorCode>200</ErrorCode>
        <ErrorMessage>error_message</ErrorMessage>
        <CompleteTime>2019-01-01T01:11:01Z</CompleteTime>
        <JobId>86c192*****5fba0</JobId>
        <FileSize>24</FileSize>
  </URLUploadInfoList>
  <NonExists>["****1", "****2"]</NonExists>
</GetURLUploadInfosResponse>

JSON format

{
	"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
	"URLUploadInfoList": [{
		"Status": "SUCCESS",
		"UploadURL": "http://****.mp4",
		"MediaId": "93ab850b4f6f*****54b6e91d24d81d4",
		"UserData": "{\"MessageCallback\":\"{\"CallbackURL\":\"http://test.test.com\"}\", \"Extend\":\"{\"localId\":\"***\", \"test\":\"www\"}\"}",
		"CreationTime": "2019-01-01T01:01:01Z",
		"ErrorCode": "200",
		"ErrorMessage": "error_message",
		"CompleteTime": "2019-01-01T01:11:01Z",
		"JobId": "86c192*****5fba0",
		"FileSize": "24"
	}],
	"NonExists": "[\"****1\", \"****2\"]"
}

Error codes

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