ApsaraVideo VOD:ApsaraVideo VOD へのリソースの移行

ステップ1：VOD SDK のインストール

この例では、Java 用の ApsaraVideo VOD SDK を使用します。その他の言語については、「VOD SDKの概要」をご参照ください。

要件：

• JDK 8 以降

• Maven 3.x または Gradle

pom.xml に依存関係を追加します。

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

ステップ2：移行元リソース URL の準備

移行するすべてのリソースのリストを作成します。

1. すべてのファイルのダウンロード URL を収集します

2. URL にファイル名と拡張子が含まれていることを確認します。

   • 正しい例：https://example.com/videos/intro.mp4

   • 誤った例：https://example.com/download?id=12345 (拡張子がない)

3. 署名付き URL の場合、移行期間中も有効であることを確認します

4. いくつかの URL をテストし、アクセス可能であることを確認します

ステップ3：バッチアップロードジョブの送信

UploadMediaByURL API を呼び出してアップロードジョブを送信します。この API は OpenAPI Explorer を使用してテストできます。

Java の例：

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) {
        // 環境変数から認証情報を読み取ります
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        String regionId = "cn-shanghai";  // VOD サービスを有効化したリージョン

        // VOD クライアントを初期化します
        DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
        DefaultAcsClient client = new DefaultAcsClient(profile);

        // アップロードリクエストを作成します
        UploadMediaByURLRequest request = new UploadMediaByURLRequest();

        // 移行元 URL を指定します (複数ファイルの場合はカンマ区切り)
        request.setUploadURLs("https://example.com/video1.mp4,https://example.com/video2.mp4");

        // オプション：トランスコーディングテンプレートグループを指定します。このパラメーターを設定しない場合、
        // VOD は移行先アカウントのデフォルトのトランスコーディングテンプレートグループを使用して、アップロードされたファイルをトランスコードします。
        // その結果、オリジナルファイルを保持する代わりに、メザニンファイルがトランスコード出力に置き換えられる場合があります。
        request.setTemplateGroupId("");

        // オプション：アップロードする動画のメタデータを設定します
        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());
        }
    }
}

コードを実行する前に：

1. 環境変数を設定します。

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

2. プレースホルダーを置き換えます。

   • <your-access-key-id>：ご自身の AccessKey ID

   • <your-access-key-secret>：ご自身の AccessKey Secret

   • regionId を VOD サービスのリージョンに更新します

   • サンプル URL を実際の移行元 URL に置き換えます

3. コンパイルして実行します。

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

ステップ4：アップロード進捗の監視

アップロードジョブのステータスを追跡するには、以下のいずれかの方法を使用します。

方法1：イベント通知 (推奨)

アップロード完了時にコールバックを受信するようにイベント通知を設定します。

1. VOD コンソールで HTTP または MNS のコールバックを設定します (「イベント通知の概要」をご参照ください)

2. UploadByURLComplete イベントをリッスンします

3. コールバックのペイロードを解析してアップロードステータスを確認します

成功時のコールバック例：

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

失敗時のコールバック例：

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

方法2：API ポーリング

GetURLUploadInfos API を定期的に呼び出して、ジョブのステータスを照会します。

GetURLUploadInfosRequest request = new GetURLUploadInfosRequest();
request.setJobIds("job-id-1,job-id-2");  // ジョブ ID (カンマ区切り)

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());
    }
}

詳細については、「GetURLUploadInfos」をご参照ください。

前提条件

• 移行元の OSS バケットと同一リージョンにデプロイされた ECS インスタンス

• ECS と OSS/VOD サービス間のネットワーク接続

操作手順

ステップ1：内部ネットワークアドレスの取得

OSS リソースの場合：

1. OSS バケット内のオブジェクトを一覧表示します (「オブジェクトの一覧表示」をご参照ください)

2. 各オブジェクトの OSS アドレスを取得します

3. リージョンの後に -internal を追加して内部ネットワークアドレスに変換します。

   • OSS アドレス：outin-xxx.oss-cn-shanghai.aliyuncs.com/video.mp4

   • 内部アドレス：outin-xxx.oss-cn-shanghai-internal.aliyuncs.com/video.mp4

VOD リソースの場合：

1. GetMezzanineInfo を OutputType=oss で呼び出し、OSS アドレスを取得します (「GetMezzanineInfo」をご参照ください)

2. 上記と同じ方法で内部ネットワークアドレスに変換します

内部ネットワークアドレスの変換：

内部エンドポイントの詳細については、「OSSの内部エンドポイントを使用してECSインスタンスからOSSリソースにアクセスする」をご参照ください。

ステップ2：ECS へのアップロードサービスのデプロイ

移行元リソースと同一リージョンの ECS インスタンスにアップロードサービスをデプロイします。regionId パラメーターを ECS のリージョンに合わせて設定します。リージョンが一致する場合、アップロード SDK は内部ネットワークエンドポイントを自動的に使用します。

アップロードコード例 (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 {
        // 環境変数から認証情報を読み取ります
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        // 内部ネットワーク URL (ステップ 1 で取得)
        String internalUrl = "https://bucket.oss-cn-shanghai-internal.aliyuncs.com/video.mp4";

        // 内部ネットワーク URL からダウンロードします
        InputStream inputStream = new URL(internalUrl).openStream();

        // アップロードリクエストを作成します
        UploadStreamRequest request = new UploadStreamRequest(
            accessKeyId,
            accessKeySecret,
            "Video Title",    // 動画タイトル
            "video.mp4",      // 拡張子付きのファイル名
            inputStream
        );

        // リージョンを設定します (内部ネットワークを使用するには ECS のリージョンと一致させる必要があります)
        request.setApiRegionId("cn-shanghai");
        request.setEcsRegionId("cn-shanghai");

        // オプション：トランスコーディングテンプレートグループを指定します。このパラメーターを設定しない場合、
        // VOD は移行先アカウントのデフォルトのトランスコーディングテンプレートグループを使用して、アップロードされたファイルをトランスコードします。
        // その結果、オリジナルファイルを保持する代わりに、メザニンファイルがトランスコード出力に置き換えられる場合があります。
        request.setTemplateGroupId("");

        // アップロードします
        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());
        }
    }
}

アップロード SDK のその他の例については、「Java 用アップロード SDK」をご参照ください。

ステップ3：バッチアップロードの実行

内部ネットワークアドレスを使用してすべてのリソースを移行するため、アップロードサービスを実行します。

操作手順

ステップ1：移行元ファイルアドレスの準備

VOD リソースの場合：

1. SearchMedia を呼び出してメディア ID を照会します (「SearchMedia」をご参照ください)

2. GetMezzanineInfo を呼び出して移行元ファイルアドレスを取得します (「GetMezzanineInfo」をご参照ください)

OSS リソースの場合：

1. OSS バケット内のオブジェクトを一覧表示します (「オブジェクトの一覧表示」をご参照ください)

2. 各オブジェクトのパブリック URL を取得します

サードパーティリソースの場合：

• 移行元プラットフォームからダウンロード URL を収集します

ステップ2：アップロードサービスのデプロイ

アップロード SDK を使用してアップロードサービスを構築します。コード例：

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

        // パブリック URL
        String sourceUrl = "https://example.com/video.mp4";

        // 移行元からダウンロードします
        InputStream inputStream = new URL(sourceUrl).openStream();

        // アップロードリクエストを作成します
        UploadStreamRequest request = new UploadStreamRequest(
            accessKeyId,
            accessKeySecret,
            "Video Title",
            "video.mp4",
            inputStream
        );

        request.setApiRegionId("cn-shanghai");  // VOD サービスリージョン

        // アップロードします
        UploadVideoImpl uploader = new UploadVideoImpl();
        UploadStreamResponse response = uploader.uploadStream(request);

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

ステップ3：移行元と移行先のマッピングの記録 (推奨)

移行後に動画を管理できるよう、移行元 URL と VOD のメディア ID のマッピングを記録します。以下の方法があります。

• マッピングをデータベースに書き込む

• マッピングをログに保存する

• アップロード時に UserData パラメーターを使用して、移行元 URL を動画メタデータに含める

ステップ4：移行済みリソースの整理 (オプション)

移行後、マッピングに基づいて動画を整理します。VOD API を使用して以下を実行できます。

• 動画タイトルと説明を更新する

• タグとカテゴリを追加する

• サムネイルとカバー画像を設定する

詳細については、「UpdateVideoInfo」をご参照ください。