Cara menginisialisasi ApsaraVideo VOD SDK untuk Python - ApsaraVideo VOD

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

Informasi latar belakang

ApsaraVideo VOD SDK dapat diinisialisasi menggunakan dua metode. Pertama, Anda dapat menginisialisasi SDK dengan pasangan AccessKey dari akun Alibaba Cloud atau Pengguna Resource Access Management (RAM) yang telah diberi izin berdasarkan kebijakan otorisasi. Pasangan AccessKey tetap valid setelah akun Alibaba Cloud atau Pengguna RAM dibuat. Metode ini direkomendasikan untuk digunakan di server. Alternatifnya, Anda dapat menginisialisasi SDK menggunakan Token STS yang diberi izin berdasarkan kebijakan otorisasi. Anda juga dapat menentukan periode validitas Token STS.

Prasyarat

ApsaraVideo VOD SDK untuk Python telah terpasang. Untuk informasi lebih lanjut, lihat Pemasangan.
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.
- Kami merekomendasikan Anda untuk tidak menuliskan ID AccessKey dan Rahasia AccessKey secara langsung ke dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam 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 dengan 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:

# -*- coding: UTF-8 -*-
import json
import traceback
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.auth.credentials import AccessKeyCredential

# Peroleh Informasi AccessKey.
def init_vod_client():
    regionId = 'cn-shanghai'   # Wilayah di mana ApsaraVideo VOD diaktifkan.
    connectTimeout = 3         # Periode timeout. Unit: detik.
    // 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. 
    // Kami merekomendasikan Anda untuk tidak menyimpan pasangan AccessKey (ID AccessKey dan Rahasia AccessKey) dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor. Akibatnya, keamanan semua sumber daya dalam akun Anda terganggu. 
    // Dalam contoh ini, ApsaraVideo VOD membaca pasangan AccessKey dari variabel lingkungan untuk melaksanakan verifikasi identitas untuk akses API. Sebelum Anda menjalankan kode contoh, konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
    credentials = AccessKeyCredential(os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'])
    return AcsClient(region_id=regionId, credential=credentials)

Inisialisasi SDK dengan 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 kepada Peran dengan Menggunakan STS.

Gunakan Token STS untuk menginisialisasi SDK. Contoh kode:

# -*- coding: UTF-8 -*-
import json
import traceback
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.auth.credentials import StsTokenCredential

# Peroleh informasi STS.
def init_vod_client(accessKeyId, accessKeySecret, securityToken):
    regionId = 'cn-shanghai'   # Wilayah di mana ApsaraVideo VOD diaktifkan.
    connectTimeout = 3         # Periode timeout. Unit: detik.
    credential = StsTokenCredential(os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'], os.environ['ALIBABA_CLOUD_SECURITY_TOKEN'])
    return AcsClient(region_id=regionId, auto_retry=True, max_retry_time=3, timeout=connectTimeout, credential=credential)