ApsaraVideo VOD:URL からのプルによるバッチアップロード

機能

• URL からのプルによるバッチアップロードは非同期タスクです。これはリアルタイムの操作ではなく、操作の適時性は保証されません。タスクを送信した後、移行とアップロードのプロセスが完了するまでに数時間、あるいは数日かかる場合があります。適時性が最優先事項である場合は、アップロード SDK を使用してファイルをアップロードするか、OSS SDK を使用してファイルをアップロードしてください。

• 同じメディアファイルの URL のアップロードタスクを送信するたびに、新しいメディア ID を持つ新しいメディアアセットが ApsaraVideo VOD に作成されます。

• URL からのプルによるバッチアップロードは、ビデオおよびオーディオフォーマットのみをサポートします。詳細については、「サポートされているメディアフォーマット」をご参照ください。

• 単一ファイルが 20 GB を超える場合、アップロードは失敗します。別のアップロード方法を使用してください。

コンソールからのアップロード

コンソールでは、[中国 (上海)] リージョンのみが [URL からプル] によるオーディオおよびビデオファイルのアップロードをサポートしています。このアップロード方法は、他のリージョンではサポートされていません。

1. ApsaraVideo VOD コンソールにログインします。

2. 左側のナビゲーションウィンドウで、[メディアアセット] の下にある [オーディオ/ビデオ] をクリックします。

3. [オーディオ/ビデオのアップロード] をクリックします。

4. [オーディオ/ビデオの追加] をクリックします。

5. アップロードするファイルを追加し、トランスコーディングを設定して、[アップロード開始] をクリックします。

   URL プル方式を選択した場合、URL にファイル名拡張子が含まれていない場合は、ファイル名拡張子を入力してください。これにより、プルタスクの成功率が向上します。ネットワークの問題やリソースが配置されているリージョンが原因で、プルタスクが失敗することがあります。タスクが失敗した場合は、ネットワークまたはリソースのサービスリージョンを調整してから再試行してください。

   

API を使用したアップロード

ApsaraVideo VOD サーバーサイド SDK を統合し、UploadMediaByURL 操作を呼び出します。この操作は、中国 (上海)、中国 (北京)、中国 (深圳)、シンガポール、および 米国 (シリコンバレー) リージョンでのみサポートされています。

サンプルコード

他の言語のサンプルコードについては、「UploadMediaByURL」の [SDK の例] セクションをご参照ください。

<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;

/**
 * URL からのプルによるバッチアップロード機能のサンプルコードです。
 *
 */
public class AudioOrVideoUploadByUrl {

    /** 
     * AccessKey 情報を読み取ります。
     */
    public static DefaultAcsClient initVodClient() throws ClientException {
    // ApsaraVideo VOD が有効化されているリージョン。
    String regionId = "cn-shanghai"; 
    // Alibaba Cloud アカウントの AccessKey は、すべての API 操作にアクセスする権限を持っています。API 呼び出しや日常の O&M には、RAM ユーザーの AccessKey を使用することをお勧めします。
    // プロジェクトコードに AccessKey ID と AccessKey Secret をハードコーディングしないことを強くお勧めします。そうしないと、AccessKey ペアが漏洩し、アカウント内のすべてのリソースのセキュリティが損なわれる可能性があります。
    // この例では、環境変数から取得した AccessKey を使用して API アクセスの ID を検証する方法を示します。サンプルコードを実行する前に、ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数を設定してください。
    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;
    }

    /**
     * URL からのプルによるバッチアップロード。
     *
     * @param client リクエストを送信するクライアント。
     * @return UploadMediaByURLResponse バッチアップロードリクエストへの応答。
     * @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");
        // ソースビデオファイルの URL。
        request.setUploadURLs(encodeUrl);

        // アップロードするビデオのメタデータ。
        JSONObject uploadMetadata = new JSONObject();
        // アップロードするソースビデオファイルの URL。これは UploadURLs の URL と一致する必要があります。
        uploadMetadata.put("SourceUrl", encodeUrl);
        // ビデオのタイトル。
        uploadMetadata.put("Title", "upload by url sample");

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

        // UserData: カスタムパラメーター設定。別の Webhook アドレスとパススルーデータが必要な場合は、このパラメーターを設定します。このパラメーターはオプションです。
        JSONObject userData = new JSONObject();

        // UserData のコールバック設定。
        // メッセージコールバック設定。指定されている場合は、これらの設定が使用されます。それ以外の場合は、グローバルイベント通知設定が使用されます。
        JSONObject messageCallback = new JSONObject();
        // Webhook アドレス。
        messageCallback.put("CallbackURL", "http://192.168.0.0/16");
        // コールバックタイプ。デフォルト値: 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);
    }

    /** 
     * サンプルリクエスト。
     */
    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 {

    /**
     * 説明