All Products
Search
Document Center

ApsaraVideo VOD:URL video upload complete

Last Updated:Jan 28, 2026

This topic describes the UploadByURLComplete event, its notification content, and callback examples.

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. The time is in UTC and follows the yyyy-MM-ddTHH:mm:ssZ format.

EventType

String

Yes

The event type. The value is UploadByURLComplete.

VideoId

String

Yes

The video ID. This field is 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 result of the upload.

  • success: The operation was successful.

  • fail: The operation failed.

ErrorCode

String

No

The error code for the job. This parameter is returned if an upload error occurs.

ErrorMessage

String

No

The error message for the job. This parameter is returned if an upload error occurs.

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",
    }