The UploadByURLComplete event is triggered when a URL-based video upload completes. It includes the upload result, video ID, and error details.
Event type
UploadByURLComplete
Event description
After you submit a job to upload a video from a URL, the UploadByURLComplete event is generated when the upload is complete.
Event content
|
Parameter Name |
Type |
Required |
Description |
|
EventTime |
String |
Yes |
The time when the event was generated, in UTC. Format: yyyy-MM-ddTHH:mm:ssZ. |
|
EventType |
String |
Yes |
The event type. The value is UploadByURLComplete. |
|
VideoId |
String |
Yes |
The video ID, populated after the video is successfully pulled. |
|
JobId |
String |
Yes |
The ID of the upload task. |
|
SourceURL |
String |
No |
The URL of the source file. |
|
Status |
String |
No |
The upload result.
|
|
ErrorCode |
String |
No |
The error code. Returned only if the upload fails. |
|
ErrorMessage |
String |
No |
The error message. Returned only if the upload fails. |
Callback examples
Note the following about the callback examples:
-
For an HTTP callback, the following content is the HTTP POST body.
-
For an MNS callback, the following content is the message body.
-
Successful upload
{ "Status": "success", "EventTime": "2017-03-20T07:49:17Z", "EventType": "UploadByURLComplete", "VideoId": "43q9fjdun3f****", "JobId": "4c815bjs83j1****", "SourceURL ": "http://example.aliyundoc.com/27ffc438-164d55217ef-0005-6884-51a-1****.mp4", "Size":"123456" } -
Failed upload
{ "Status": "fail", "EventTime": "2017-03-20T07:49:17Z", "EventType": "UploadByURLComplete", "ErrorCode ": "URLInvalidError ", "ErrorMessage ": "download video failed by the url, please check it", "JobId": "4c815bjsued****" , "SourceURL ": "http://example.aliyundoc.com/27ffc438-164d55217ef-0005-6884-51a-1****.mp4", }