Inisialisasi ApsaraVideo VOD SDK untuk Java - ApsaraVideo VOD

Topik ini menjelaskan cara menginisialisasi ApsaraVideo VOD SDK untuk Java menggunakan pasangan AccessKey atau Token Layanan Keamanan (STS). Anda dapat memilih salah satu metode sesuai kebutuhan bisnis Anda.

Informasi latar belakang

ApsaraVideo VOD SDK dapat diinisialisasi dengan dua metode. Pertama, Anda dapat menggunakan pasangan AccessKey dari akun Alibaba Cloud atau pengguna Resource Access Management (RAM) yang memiliki izin berdasarkan kebijakan otorisasi. Pasangan AccessKey tetap valid setelah akun atau pengguna RAM dibuat, dan kami merekomendasikan metode ini untuk digunakan di server. Alternatifnya, Anda dapat menggunakan token STS yang diberi izin sesuai kebijakan otorisasi. Anda dapat menentukan periode validitas token STS.

Prasyarat

ApsaraVideo VOD SDK untuk Java telah diinstal. Untuk informasi lebih lanjut, lihat Instalasi.
Pengguna Resource Access Management (RAM) telah dibuat, dan izin yang diperlukan telah diberikan kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Buat dan Berikan Izin kepada Pengguna RAM.
Konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET. Untuk informasi lebih lanjut, lihat Konfigurasi Variabel Lingkungan di Linux, macOS, dan Windows.
Penting
- Pasangan AccessKey dari akun Alibaba Cloud memiliki izin untuk semua Operasi API. Kami merekomendasikan Anda menggunakan pasangan AccessKey dari pengguna RAM untuk memanggil Operasi API atau melakukan pemeliharaan rutin O&M.
- Kami merekomendasikan Anda tidak menyematkan kode keras ID AccessKey dan Rahasia AccessKey ke dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya di akun Anda akan terganggu.
Wilayah telah ditentukan untuk menggunakan ApsaraVideo VOD. Misalnya, jika Anda menggunakan ApsaraVideo VOD di wilayah Tiongkok (Shanghai), ID wilayahnya adalah cn-shanghai. Untuk informasi lebih lanjut, lihat Pusat VOD dan Titik Akhir.

Inisialisasi SDK menggunakan pasangan AccessKey

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 Memperoleh Pasangan AccessKey.

Gunakan pasangan AccessKey untuk menginisialisasi SDK. Contoh kode:

import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;

// Dapatkan Informasi AccessKey.
public static DefaultAcsClient initVodClient() throws ClientException {
    String regionId = "cn-shanghai";  // Tentukan wilayah di mana ApsaraVideo VOD diaktifkan.
    // Pasangan AccessKey dari akun Alibaba Cloud memiliki izin untuk semua Operasi API. Kami merekomendasikan Anda menggunakan pengguna RAM untuk memanggil Operasi API atau melakukan pemeliharaan rutin O&M. 
    // Kami merekomendasikan Anda tidak menyertakan pasangan AccessKey (ID AccessKey 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;
}

Inisialisasi SDK menggunakan token STS

Token STS diperoleh untuk menginisialisasi SDK. Untuk informasi lebih lanjut tentang cara memperoleh token STS, lihat bagian "Gunakan STS untuk Mengotorisasi Akses" dari topik Buat Peran dan Berikan Izin Akses Sementara ke Peran Menggunakan STS.

Gunakan token STS untuk menginisialisasi SDK. Contoh kode:

import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;

// Dapatkan informasi STS.
public static DefaultAcsClient initVodClient() throws ClientException {
    String regionId = "cn-shanghai";  // Tentukan wilayah di mana ApsaraVideo VOD diaktifkan.
    DefaultProfile profile = DefaultProfile.getProfile(
            regionId,           				                // ID wilayah
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),       // ID AccessKey dari akun RAM
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),   // Rahasia AccessKey dari akun RAM
            System.getenv("ALIBABA_CLOUD_SECURITY_TOKEN"));     // Token STS
    DefaultAcsClient client = new DefaultAcsClient(profile);
    return client;
}