ApsaraVideo VOD:Batch upload by pulling from URLs

Features

• Batch upload by pulling from URLs is an asynchronous task. It is not a real-time operation, and the timeliness of the operation is not guaranteed. After you submit a task, the migration and upload process may take several hours or even days to complete. If timeliness is a high priority, use the upload SDK to upload files or use the OSS SDK to upload files.

• Each time you submit an upload task for the same media file URL, a new media asset with a new media ID is created in ApsaraVideo VOD.

• Batch upload by pulling from URLs supports only video and audio formats. For more information, see Supported media formats.

• If a single file is larger than 20 GB, the upload will fail. Use a different upload method.

Upload through the console

In the console, only the China (Shanghai) region supports uploading audio and video files by Pulling From URLs. This upload method is not supported in other regions.

1. Log on to the ApsaraVideo VOD console.

2. In the left-side navigation pane, choose Media Files > Audio/Video.

3. Click Upload.

   

4. Click Add Media.

   

5. Add the files to upload, configure transcoding, and click Start Upload.

   When you select the URL pull method, enter the file name extension if the URL does not contain one. This increases the success rate of the pull task. A pull task may fail due to network issues or the region where the resource is located. If a task fails, try again after you adjust the network or the service region of the resource.

   

Upload using an API

Integrate the ApsaraVideo VOD server-side SDK and call the UploadMediaByURL operation. This operation is supported only in the China (Shanghai), China (Beijing), China (Shenzhen), Singapore, and US (Silicon Valley) regions.

Sample code

For sample code in other languages, see the SDK Example section of UploadMediaByURL.

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.6.1</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-vod</artifactId>
  <version>2.16.32</version>
</dependency>

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.auth.AlibabaCloudCredentials;
import com.aliyuncs.auth.EnvironmentVariableCredentialsProvider;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.vod.model.v20170321.UploadMediaByURLRequest;
import com.aliyuncs.vod.model.v20170321.UploadMediaByURLResponse;

import java.net.URLEncoder;

/**
 * Sample code for the batch upload by pulling from URLs feature.
 *
 */
public class AudioOrVideoUploadByUrl {

    /** 
     * Reads the AccessKey information.
     */
    public static DefaultAcsClient initVodClient() throws ClientException {
    // The region where ApsaraVideo VOD is activated.
    String regionId = "cn-shanghai"; 
    // The AccessKey of an Alibaba Cloud account has permissions to access all API operations. We recommend that you use the AccessKey of a RAM user for API calls or routine O&M.
    // We strongly recommend that you do not hard-code the AccessKey ID and AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, which compromises the security of all resources in your account.
    // This example shows how to use an AccessKey that is obtained from environment variables to verify your identity for API access. Before you run the sample code, configure the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables.
    DefaultProfile profile = DefaultProfile.getProfile(regionId, System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
    DefaultAcsClient client = new DefaultAcsClient(profile);
    return client;
    }

    /**
     * Batch upload by pulling from URLs.
     *
     * @param client The client that sends requests.
     * @return UploadMediaByURLResponse The response to the batch upload request.
     * @throws Exception
     */
    public static UploadMediaByURLResponse uploadMediaByURL(DefaultAcsClient client) throws Exception {
        UploadMediaByURLRequest request = new UploadMediaByURLRequest();
        String url = "http://video_01.mp4";
        String encodeUrl = URLEncoder.encode(url, "UTF-8");
        // The URL of the source video file.
        request.setUploadURLs(encodeUrl);

        // The metadata of the video to upload.
        JSONObject uploadMetadata = new JSONObject();
        // The URL of the source video file to upload. This must match the URL in UploadURLs.
        uploadMetadata.put("SourceUrl", encodeUrl);
        // The video title.
        uploadMetadata.put("Title", "upload by url sample");

        JSONArray uploadMetadataList = new JSONArray();
        uploadMetadataList.add(uploadMetadata);
        request.setUploadMetadatas(uploadMetadataList.toJSONString());

        // UserData: Custom parameter settings. Set this parameter if you need a separate webhook address and pass-through data. This parameter is optional.
        JSONObject userData = new JSONObject();

        // Callback settings in UserData.
        // Message callback settings. If specified, these settings are used. Otherwise, the global event notification settings are used.
        JSONObject messageCallback = new JSONObject();
        // The webhook address.
        messageCallback.put("CallbackURL", "http://192.168.0.0/16");
        // The callback type. Default value: http.
        messageCallback.put("CallbackType", "http");
        userData.put("MessageCallback", messageCallback.toJSONString());

        JSONObject extend = new JSONObject();
        extend.put("MyId", "user-defined-id");
        userData.put("Extend", extend.toJSONString());

        request.setUserData(userData.toJSONString());

        return client.getAcsResponse(request);
    }

    /** 
     * Sample request.
     */
    public static void main(String[] argv) {

        try {
            DefaultAcsClient client = initVodClient();
            UploadMediaByURLResponse response = uploadMediaByURL(client);
            System.out.print("UploadJobs = " + JSON.toJSONString(response.getUploadJobs()) + "\n");
            System.out.print("RequestId = " + response.getRequestId() + "\n");
        } catch (Exception e) {
            System.out.print("ErrorMessage = " + e.getLocalizedMessage());
        }
    }

}

    <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>vod20170321</artifactId>
      <version>3.6.4</version>
    </dependency>

package com.aliyun.sample;
import com.aliyun.tea.*;

public class UploadMediaByURL {

    /**
     * description