ApsaraVideo VOD：Migrasi Sumber Daya ke ApsaraVideo VOD

Skenario migrasi dan metode

ApsaraVideo VOD mendukung beberapa metode migrasi. Anda dapat memigrasi sumber daya yang disimpan di situs web pribadi dan layanan cloud pihak ketiga ke ApsaraVideo VOD, memigrasi sumber daya yang tersimpan di Object Storage Service (OSS) ke ApsaraVideo VOD dalam satu akun Alibaba Cloud atau di antara akun Alibaba Cloud yang berbeda, serta memigrasi sumber daya di ApsaraVideo VOD di antara akun Alibaba Cloud yang berbeda.

Setelah Anda memigrasi video ke ApsaraVideo VOD, informasi video seperti ID video, URL pemutaran, dan URL gambar mini akan dibuat di ApsaraVideo VOD. Anda perlu mengaitkan informasi video sebelum migrasi dengan informasi setelah migrasi.

Sebelum Anda mulai

• Akun Alibaba Cloud telah dibuat dan verifikasi identitas telah selesai. Untuk membuat akun Alibaba Cloud, kunjungi situs resmi Alibaba Cloud. Untuk informasi lebih lanjut, lihat Buat akun Alibaba Cloud.

• Peroleh pasangan AccessKey untuk menyelesaikan verifikasi identitas sehingga Anda dapat memanggil operasi API ApsaraVideo VOD. Untuk informasi lebih lanjut tentang cara memperoleh pasangan AccessKey, lihat Peroleh pasangan AccessKey.

  Catatan

  Untuk memigrasi sumber daya sebagai pengguna RAM, Anda harus membuat pengguna RAM sebelum memperoleh pasangan AccessKey. Untuk informasi lebih lanjut, lihat Buat dan berikan izin kepada pengguna RAM.

(Direkomendasikan) Unggah sumber daya secara massal berdasarkan URL

Skema

Jika Anda ingin memigrasi sumber daya yang tidak disimpan di server atau perangkat lokal dan sumber daya tersebut dapat diakses publik, kami merekomendasikan agar Anda memigrasi sumber daya secara massal berdasarkan URL. Dengan cara ini, Anda dapat mengunggah sejumlah besar file melalui jaringan internal dengan cepat dan mengurangi penggunaan lalu lintas.

Batasan

Anda hanya dapat mengunggah sumber daya secara massal berdasarkan URL di wilayah Cina (Shanghai), Cina (Beijing), Cina (Shenzhen), Singapura, dan AS (Silicon Valley). Anda dapat menggunakan metode lain untuk memigrasi sumber daya di wilayah lain. Untuk informasi lebih lanjut, lihat ID Wilayah ApsaraVideo VOD.

Catatan Penggunaan

• Pekerjaan unggah berbasis URL bersifat asinkron. Setelah Anda mengirimkan pekerjaan unggah berbasis URL, mungkin diperlukan waktu berjam-jam, bahkan berhari-hari untuk menyelesaikannya. Jika Anda memerlukan tingkat ketepatan waktu yang tinggi, kami merekomendasikan agar Anda menggunakan upload SDK.

• Setiap kali Anda mengirimkan pekerjaan unggah menggunakan URL, ID media baru akan dibuat di ApsaraVideo VOD.

Proses Migrasi

Prosedur

1. Integrasikan ApsaraVideo VOD SDK.

   Dalam contoh ini digunakan ApsaraVideo VOD SDK for Java. Untuk informasi lebih lanjut tentang cara menggunakan ApsaraVideo VOD SDK dalam bahasa pemrograman lainnya, lihat Catatan Penggunaan.

   Untuk informasi lebih lanjut tentang cara mengunduh dan menginstal SDK for Java, lihat Pengenalan SDK dan Instalasi.

2. Siapkan sumber daya yang ingin Anda migrasikan.

   Catatan

   • Anda harus menyiapkan URL unduhan semua file yang ingin Anda migrasikan. Jika penandatanganan URL diaktifkan, pastikan bahwa URL valid selama proses unduhan.

   • URL unduhan harus mencakup nama file dan ekstensi nama file, seperti https://****.mp4.

3. Panggil operasi UploadMediaByURL menggunakan ApsaraVideo VOD SDK untuk mengunggah sumber daya secara massal.

   Dalam contoh berikut digunakan ApsaraVideo VOD SDK for Java. Untuk informasi lebih lanjut tentang cara memanggil operasi API menggunakan ApsaraVideo VOD SDK dalam bahasa pemrograman lainnya, lihat Unggah file secara massal menggunakan URL.

   Anda dapat melakukan debugging online menggunakan OpenAPI Explorer.

   Tampilkan kode contoh dalam Java

   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;
   
   /**
    * Kode contoh untuk mengunggah file media sekaligus berdasarkan URL
    *
    */
   public class AudioOrVideoUploadByUrl {
   
       /** 
        * Peroleh informasi AccessKey.
        */
       public static DefaultAcsClient initVodClient() throws ClientException {
       // Wilayah tempat ApsaraVideo VOD diaktifkan.
       String regionId = "cn-shanghai"; 
       // Pasangan AccessKey dari akun Alibaba Cloud memiliki izin pada semua operasi API. Kami merekomendasikan agar Anda menggunakan pengguna RAM untuk memanggil operasi API atau melakukan O&M rutin. 
       // Kami merekomendasikan agar Anda tidak menyertakan pasangan AccessKey (AccessKey ID dan Rahasia AccessKey) dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. 
       // Dalam contoh ini, ApsaraVideo VOD membaca pasangan AccessKey dari variabel lingkungan untuk mengimplementasikan verifikasi identitas untuk akses API. Sebelum Anda menjalankan kode contoh, konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan 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;
       }
   
       /**
        * Unggah file media sekaligus berdasarkan URL.
        *
        * @param client Klien yang mengirim permintaan.
        * @return UploadMediaByURLResponse Bidang yang terkandung dalam respons.
        * @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 file sumber.
           request.setUploadURLs(encodeUrl);
   
           // Metadata video yang ingin Anda unggah.
           JSONObject uploadMetadata = new JSONObject();
           // URL file sumber yang ingin Anda unggah. URL harus disertakan dalam nilai parameter UploadURLs.
           uploadMetadata.put("SourceUrl", encodeUrl);
           // Judul video.
           uploadMetadata.put("Title", "upload by url sample");
   
           JSONArray uploadMetadataList = new JSONArray();
           uploadMetadataList.add(uploadMetadata);
           request.setUploadMetadatas(uploadMetadataList.toJSONString());
   
           // Opsional. Data pengguna yang terdiri dari parameter yang ditentukan pengguna. Konfigurasikan data pengguna jika Anda memerlukan URL panggilan balik dan transmisi data transparan.
           JSONObject userData = new JSONObject();
   
           // Konfigurasi panggilan balik dalam data pengguna.
           // Pengaturan panggilan balik untuk notifikasi peristiwa. Jika Anda menentukan pengaturan panggilan balik, pengaturan panggilan balik yang ditentukan akan berlaku. Jika tidak, pengaturan panggilan balik global yang berlaku.
           JSONObject messageCallback = new JSONObject();
           // URL panggilan balik.
           messageCallback.put("CallbackURL", "http://192.168.0.0/16");
           // Jenis panggilan balik. Nilai default: 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);
       }
   
       /** 
        * Contoh permintaan
        */
       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());
           }
       }
   
   }

4. Gunakan salah satu metode berikut untuk memperoleh hasil unggahan.

   Metode 1: Gunakan notifikasi peristiwa

   ApsaraVideo VOD mendukung panggilan balik HTTP dan panggilan balik MNS. Setelah Anda mengonfigurasi notifikasi peristiwa, ApsaraVideo VOD akan mengirimkan notifikasi kepada Anda saat file media diproses berdasarkan metode panggilan balik yang Anda tentukan. Misalnya, ApsaraVideo VOD memberi tahu Anda saat file media diunggah atau dikodekan ulang. Untuk informasi lebih lanjut, lihat Ikhtisar.

   Anda dapat memperoleh informasi tentang pekerjaan unggah massal berbasis URL seperti status pekerjaan dari panggilan balik UploadByURLComplete. Untuk informasi lebih lanjut, lihat UploadByURLComplete (untuk unggahan video). Anda dapat memperoleh informasi seperti status unggahan dari panggilan balik.

   • Contoh panggilan balik unggahan berhasil

     { 
       "Status": "success",
       "EventTime": "2017-03-20T07:49:17Z",
       "EventType": "UploadByURLComplete", 
       "VideoId": "43q9fjdun3f****", 
       "JobId": "4c815bjs83j1****", 
       "SourceURL ": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164d55217ef-0005-6884-51a-1****.mp4",
       "Size":"123456"
     }

   • Contoh panggilan balik unggahan gagal

     { 
       "Status": "fail",
       "EventTime": "2017-03-20T07:49:17Z",
       "EventType": "UploadByURLComplete", 
       "ErrorCode ": "URLInvalidError ", 
       "ErrorMessage ": "download video failed by the url, please check it", 
       "JobId": "4c815bjsued1****" ,
       "SourceURL ": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164d55217ef-0005-6884-51a-1****.mp4"
     }

   Metode 2: Panggil operasi API

   Anda dapat memanggil operasi GetURLUploadInfos untuk menanyakan informasi tentang pekerjaan unggah massal berbasis URL seperti status pekerjaan. Untuk informasi lebih lanjut, lihat GetURLUploadInfos.

Unggah sumber daya menggunakan layanan unggah mandiri

Jika unggahan massal berbasis URL tidak didukung di wilayah layanan Anda atau Anda memerlukan tingkat ketepatan waktu unggahan yang tinggi, unduh sumber daya ke perangkat lokal Anda dan gunakan SDK unggah untuk mengunggah sumber daya ke ApsaraVideo VOD. Jika Anda menyiapkan layanan unggah di instance Elastic Compute Service (ECS), Anda dapat mengunggah sumber daya melalui jaringan internal atau melalui Internet berdasarkan wilayah tempat instance ECS Anda berada.

Tambahkan bucket OSS ke ApsaraVideo VOD dan daftarkan sumber daya

Skenario

Untuk memigrasi sumber daya OSS ke ApsaraVideo VOD dalam satu akun Alibaba Cloud, tambahkan bucket OSS ke ApsaraVideo VOD dan daftarkan sumber daya. Dengan cara ini, Anda tidak perlu mengunggah sumber daya.

Batasan

• Anda hanya dapat menambahkan bucket OSS dengan kelas penyimpanan Standar ke ApsaraVideo VOD.

• Anda dapat menambahkan hingga 10 bucket OSS ke ApsaraVideo VOD di setiap wilayah.

Prosedur

1. Tambahkan bucket OSS tempat sumber daya yang ingin Anda migrasikan berada ke ApsaraVideo VOD.

   Untuk informasi lebih lanjut tentang prosedur dan deskripsi parameter, lihat Kelola bucket penyimpanan.

2. Panggil operasi untuk mendaftarkan sumber daya OSS dengan ApsaraVideo VOD.

   1. Daftar objek yang disimpan di bucket OSS menggunakan SDK OSS atau memanggil operasi API. Untuk informasi lebih lanjut, lihat Daftar objek.

   2. Panggil operasi RegisterMedia untuk mendaftarkan sumber daya media dan menghasilkan ID media. Untuk informasi lebih lanjut, lihat RegisterMedia. Atur FileURL di RegisterMetadatas ke jalur lengkap objek yang Anda peroleh dengan mendaftar objek OSS. Anda harus menambahkan nama domain OSS ke jalur file. Contoh URL:

      https://oss-cn-hangzhou.aliyuncs.com/video/example.mp4

Siapkan layanan unggah

Jika Anda ingin memigrasi sumber daya pihak ketiga atau memigrasi sumber daya di antara akun Alibaba Cloud, Anda harus mengunduh sumber daya video asli, lalu gunakan alat unggah untuk mengunggah sumber daya ke ApsaraVideo VOD. ApsaraVideo VOD memungkinkan Anda mengunggah sumber daya menggunakan upload SDK atau ApsaraVideo VOD SDK. Layanan unggah dapat diimplementasikan menggunakan upload SDK atau ApsaraVideo VOD API. Kami merekomendasikan agar Anda menyiapkan layanan unggah menggunakan upload SDK. Dengan cara ini, sumber daya diunggah secara sinkron dan efisien. Proses menyiapkan layanan unggah menggunakan ApsaraVideo VOD API kompleks.

Prosedur

1. Integrasikan upload SDK atau ApsaraVideo VOD SDK.

   Anda dapat mengintegrasikan upload SDK atau ApsaraVideo VOD SDK berdasarkan bahasa pemrograman yang Anda gunakan. Untuk informasi lebih lanjut tentang cara mengintegrasikan upload SDK, lihat Ikhtisar. Untuk informasi lebih lanjut tentang cara mengintegrasikan ApsaraVideo VOD SDK, lihat Catatan Penggunaan.

2. Tulis kode layanan unggah. Kode contoh berikut memberikan contoh cara menulis kode:

(Direkomendasikan) Siapkan layanan unggah menggunakan upload SDK

Kode berikut dalam Java digunakan sebagai contoh. Untuk informasi lebih lanjut tentang upload SDK dalam bahasa pemrograman lainnya, lihat Ikhtisar.

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

/**
 * Gunakan upload SDK untuk mengunggah file video.
 */
public class UploadStreamDemo {
    /**
     * Operasi unggah aliran.
     *
     * @param accessKeyId
     * @param accessKeySecret
     * @param title
     * @param fileName
     * @param inputStream
     */
    private static void testUploadStream(String accessKeyId, String accessKeySecret, String title, String fileName, InputStream inputStream) {
        UploadStreamRequest request = new UploadStreamRequest(accessKeyId, accessKeySecret, title, fileName, inputStream);
        
        /* Tentukan pengaturan panggilan balik kustom untuk notifikasi peristiwa. Untuk informasi lebih lanjut tentang parameter, lihat Tipe Data Dasar. */
        //request.setUserData(""{\"Extend\":{\"test\":\"www\",\"localId\":\"xxxx\"},\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"}}"");
        /* Opsional. Tentukan ID kategori video. */
        //request.setCateId(0);
        /* Opsional. Tentukan tag video. Pisahkan beberapa tag dengan koma (,). */
        //request.setTags("Tag 1,Tag 2");
        /* Opsional. Tentukan deskripsi video. */
        //request.setDescription("Deskripsi Video");
        /* Opsional. Tentukan URL gambar mini. Contoh: http://****.example.com/image_01.jpg. */
        //request.setCoverURL("<Your CoverURL>");
        /* Opsional. Tentukan ID grup template. */
        //request.setTemplateGroupId("8c4792cbc8694e****fd5330e56a33d");
        /* Opsional. Tentukan ID alur kerja. */
        //request.setWorkflowId("d4430d07361f****1339577859b0177b");
        /* Opsional. Tentukan wilayah penyimpanan. */
        //request.setStorageLocation("outin-20170323****266-5sejdln9o.oss-cn-shanghai.aliyuncs.com");
        /* Tentukan wilayah akses VOD. */
        request.setApiRegionId("cn-shanghai");
        /* Tentukan wilayah tempat instance ECS diterapkan. */
        // request.setEcsRegionId("cn-shanghai");
        UploadVideoImpl uploader = new UploadVideoImpl();
        UploadStreamResponse response = uploader.uploadStream(request);
        System.out.print("RequestId=" + response.getRequestId() + "\n"); // Tentukan ID permintaan yang dikirim ke VOD.
        if (response.isSuccess()) {
            System.out.print("VideoId=" + response.getVideoId() + "\n");
        } else { // Jika URL panggilan balik yang Anda tentukan tidak valid, proses unggah tidak terpengaruh. ID video dan kode kesalahan dikembalikan. Jika ID video kosong, unggahan gagal. Analisis penyebab berdasarkan kode kesalahan yang dikembalikan.
            System.out.print("VideoId=" + response.getVideoId() + "\n");
            System.out.print("ErrorCode=" + response.getCode() + "\n");
            System.out.print("ErrorMessage=" + response.getMessage() + "\n");
        }
    }

    public static void main(String[] args) {
        /**
         * Tentukan URL video sumber, lewati informasi tentang video, dan unggah video.
         */
        InputStream inputStream = null;
        // URL video. Contoh: http://example.aliyundoc.com/video/****.mp4.
        String url = "<Your File URL>";
        try {
            inputStream = new URL(url).openStream();
        } catch (IOException e) {
            e.printStackTrace();
        }
        // Pasangan AccessKey dari akun Alibaba Cloud memiliki izin untuk memanggil semua operasi API. Kami merekomendasikan agar Anda menggunakan pasangan AccessKey pengguna RAM untuk memanggil operasi API atau melakukan O&M rutin. 
        // Kami merekomendasikan agar Anda tidak menyertakan pasangan AccessKey (AccessKey ID dan Rahasia AccessKey) dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. 
        // Dalam contoh ini, ApsaraVideo VOD membaca pasangan AccessKey dari variabel lingkungan untuk mengimplementasikan verifikasi identitas untuk akses API. Sebelum Anda menjalankan kode contoh, konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        // Dalam kode berikut, AccessKey ID dan AccessKey Secret adalah pasangan AccessKey yang Anda peroleh. <Judul Video Anda> adalah judul video. <Video Anda dengan Ekstensi File> adalah nama file video yang mencakup ekstensi nama file, seperti video-1.mp4. 
        testUploadStream(accessKeyId, accessKeySecret, "<Judul Video Anda>", "<Video Anda dengan Ekstensi File>", inputStream);
    }
}

Siapkan layanan unggah menggunakan ApsaraVideo VOD API

Untuk menyiapkan layanan unggah menggunakan ApsaraVideo VOD SDK untuk memanggil operasi API, Anda harus mengimplementasikan logika untuk seluruh proses unggah. Anda perlu memperoleh URL unggah dan kredensial dari ApsaraVideo VOD, mendekode URL unggah dan kredensial yang dienkripsi Base64, lalu menggunakan SDK OSS untuk mengunggah file media. Dalam hal ini, operasi kompleks dan rentan terhadap kesalahan. Kami merekomendasikan agar Anda menggunakan upload SDK untuk menyiapkan layanan unggah. Untuk informasi lebih lanjut tentang logika unggah lengkap, lihat Unggah file media dengan memanggil ApsaraVideo VOD API.