ApsaraVideo VOD:Migrate resources to ApsaraVideo VOD

Step 1: Install the VOD SDK

This example uses the ApsaraVideo VOD SDK for Java. For other languages, see VOD SDK overview.

Requirements:

• JDK 8 or later

• Maven 3.x or Gradle

Add the dependency to your pom.xml:

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-vod</artifactId>
    <version>2.16.11</version>
</dependency>

Step 2: Prepare source resource URLs

Create a list of all resources to migrate:

1. Collect download URLs for all files

2. Ensure URLs include file names and extensions:

   • Correct: https://example.com/videos/intro.mp4

   • Incorrect: https://example.com/download?id=12345 (no file extension)

3. For signed URLs, verify they remain valid during migration

4. Test a few URLs to confirm they're accessible

Step 3: Submit batch upload jobs

Call the UploadMediaByURL operation to submit upload jobs. You can test this API using OpenAPI Explorer.

Java example:

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.vod.model.v20170321.UploadMediaByURLRequest;
import com.aliyuncs.vod.model.v20170321.UploadMediaByURLResponse;

public class UploadByURL {
    public static void main(String[] args) {
        // Read credentials from environment variables
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        String regionId = "cn-shanghai";  // Region where VOD service is activated

        // Initialize VOD client
        DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
        DefaultAcsClient client = new DefaultAcsClient(profile);

        // Create upload request
        UploadMediaByURLRequest request = new UploadMediaByURLRequest();

        // Specify source URLs (comma-separated for multiple files)
        request.setUploadURLs("https://example.com/video1.mp4,https://example.com/video2.mp4");

        // Optional: Specify a transcoding template group. If you don't set this parameter,
        // VOD transcodes the uploaded file using the destination account's default
        // transcoding template group, which may replace the mezzanine file with a
        // transcoded output instead of preserving the original file.
        request.setTemplateGroupId("");

        // Optional: Set metadata for uploaded videos
        request.setUploadMetadatas("[{\"Title\":\"Video 1\"},{\"Title\":\"Video 2\"}]");

        try {
            UploadMediaByURLResponse response = client.getAcsResponse(request);
            System.out.println("Request ID: " + response.getRequestId());
            System.out.println("Upload jobs created:");
            for (UploadMediaByURLResponse.UploadJob job : response.getUploadJobs()) {
                System.out.println("- Job ID: " + job.getJobId());
                System.out.println("  Source URL: " + job.getSourceURL());
            }
        } catch (Exception e) {
            System.err.println("Upload failed: " + e.getMessage());
        }
    }
}

Before running the code:

1. Set environment variables:

   export ALIBABA_CLOUD_ACCESS_KEY_ID="<your-access-key-id>"
   export ALIBABA_CLOUD_ACCESS_KEY_SECRET="<your-access-key-secret>"
   

2. Replace placeholders:

   • <your-access-key-id>: Your AccessKey ID

   • <your-access-key-secret>: Your AccessKey Secret

   • Update regionId to your VOD service region

   • Replace example URLs with your actual source URLs

3. Compile and run:

   mvn compile exec:java -Dexec.mainClass="UploadByURL"
   

Step 4: Monitor upload progress

Choose one of the following methods to track upload job status:

Method 1: Event notifications (Recommended)

Configure event notifications to receive callbacks when uploads complete:

1. Set up HTTP or MNS callbacks in the VOD console (see Event notification overview)

2. Listen for UploadByURLComplete events

3. Parse the callback payload to check upload status

Success callback example:

{
  "Status": "success",
  "EventTime": "2026-03-10T09:15:00Z",
  "EventType": "UploadByURLComplete",
  "VideoId": "43q9fjdun3f2a5b",
  "JobId": "4c815bjs83j1d8f",
  "SourceURL": "https://example.com/video.mp4",
  "Size": "123456789"
}

Failure callback example:

{
  "Status": "fail",
  "EventTime": "2026-03-10T09:15:00Z",
  "EventType": "UploadByURLComplete",
  "ErrorCode": "URLInvalidError",
  "ErrorMessage": "Download video failed by the URL, please check it",
  "JobId": "4c815bjsued1f9a",
  "SourceURL": "https://example.com/invalid-video.mp4"
}

Method 2: API polling

Call the GetURLUploadInfos operation periodically to query job status:

GetURLUploadInfosRequest request = new GetURLUploadInfosRequest();
request.setJobIds("job-id-1,job-id-2");  // Comma-separated job IDs

GetURLUploadInfosResponse response = client.getAcsResponse(request);
for (GetURLUploadInfosResponse.UrlUploadJobInfo job : response.getURLUploadInfoList()) {
    System.out.println("Job ID: " + job.getJobId());
    System.out.println("Status: " + job.getStatus());  // NotStarted/Uploading/Success/Failed
    if ("Success".equals(job.getStatus())) {
        System.out.println("Video ID: " + job.getVideoId());
    }
}

For more information, see GetURLUploadInfos.

Prerequisites

• An ECS instance deployed in the same region as the source OSS bucket

• Network connectivity between ECS and OSS/VOD services

Procedure

Step 1: Obtain internal network addresses

For OSS resources:

1. List objects in your OSS bucket (see List objects)

2. Get the OSS address for each object

3. Convert to internal network address by adding -internal after the region:

   • OSS address: outin-xxx.oss-cn-shanghai.aliyuncs.com/video.mp4

   • Internal address: outin-xxx.oss-cn-shanghai-internal.aliyuncs.com/video.mp4

For VOD resources:

1. Call GetMezzanineInfo with OutputType=oss to get OSS addresses (see GetMezzanineInfo)

2. Convert to internal network addresses using the same method above

Internal network address conversion:

For more information about internal endpoints, see Access OSS resources from ECS instances by using the internal endpoint of OSS.

Step 2: Deploy upload service on ECS

Deploy your upload service on an ECS instance in the same region as your source resources. Set the regionId parameter to match the ECS region. The upload SDK automatically uses internal network endpoints when the regions match.

Example upload code (Java):

import com.aliyun.vod.upload.impl.UploadVideoImpl;
import com.aliyun.vod.upload.req.UploadStreamRequest;
import com.aliyun.vod.upload.resp.UploadStreamResponse;
import java.io.InputStream;
import java.net.URL;

public class InternalNetworkUpload {
    public static void main(String[] args) throws Exception {
        // Read credentials from environment variables
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        // Internal network URL (obtained in Step 1)
        String internalUrl = "https://bucket.oss-cn-shanghai-internal.aliyuncs.com/video.mp4";

        // Download from internal network URL
        InputStream inputStream = new URL(internalUrl).openStream();

        // Create upload request
        UploadStreamRequest request = new UploadStreamRequest(
            accessKeyId,
            accessKeySecret,
            "Video Title",    // Video title
            "video.mp4",      // File name with extension
            inputStream
        );

        // Set region (must match ECS region for internal network)
        request.setApiRegionId("cn-shanghai");
        request.setEcsRegionId("cn-shanghai");

        // Optional: Specify a transcoding template group. If you don't set this parameter,
        // VOD transcodes the uploaded file using the destination account's default
        // transcoding template group, which may replace the mezzanine file with a
        // transcoded output instead of preserving the original file.
        request.setTemplateGroupId("");

        // Upload
        UploadVideoImpl uploader = new UploadVideoImpl();
        UploadStreamResponse response = uploader.uploadStream(request);

        if (response.isSuccess()) {
            System.out.println("Upload successful");
            System.out.println("Video ID: " + response.getVideoId());
        } else {
            System.err.println("Upload failed: " + response.getMessage());
        }
    }
}

For more upload SDK examples, see Upload SDK for Java.

Step 3: Execute batch upload

Run your upload service to migrate all resources using internal network addresses.

Procedure

Step 1: Prepare source file addresses

For VOD resources:

1. Call SearchMedia to query video IDs (see SearchMedia)

2. Call GetMezzanineInfo to get source file addresses (see GetMezzanineInfo)

For OSS resources:

1. List objects in your OSS bucket (see List objects)

2. Get public URLs for each object

For third-party resources:

• Collect download URLs from your source platform

Step 2: Deploy upload service

Set up your upload service using the upload SDK. Example code:

import com.aliyun.vod.upload.impl.UploadVideoImpl;
import com.aliyun.vod.upload.req.UploadStreamRequest;
import com.aliyun.vod.upload.resp.UploadStreamResponse;
import java.io.InputStream;
import java.net.URL;

public class InternetUpload {
    public static void main(String[] args) throws Exception {
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        // Public URL
        String sourceUrl = "https://example.com/video.mp4";

        // Download from source
        InputStream inputStream = new URL(sourceUrl).openStream();

        // Create upload request
        UploadStreamRequest request = new UploadStreamRequest(
            accessKeyId,
            accessKeySecret,
            "Video Title",
            "video.mp4",
            inputStream
        );

        request.setApiRegionId("cn-shanghai");  // VOD service region

        // Upload
        UploadVideoImpl uploader = new UploadVideoImpl();
        UploadStreamResponse response = uploader.uploadStream(request);

        if (response.isSuccess()) {
            System.out.println("Video ID: " + response.getVideoId());
        }
    }
}

Step 3: Track source-to-destination mappings (Recommended)

To manage videos after migration, record mappings between source URLs and VOD video IDs. You can:

• Write mappings to a database

• Store mappings in logs

• Include source URLs in video metadata using the UserData parameter during upload

Step 4: Organize migrated resources (Optional)

After migration, organize your videos based on the mappings. Use VOD APIs to:

• Update video titles and descriptions

• Add tags and categories

• Set thumbnails and cover images

For more information, see UpdateVideoInfo.