Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Initialisation

Dernière mise à jour :Aug 10, 2026

Cette rubrique explique comment initialiser le SDK ApsaraVideo VOD pour Python à l'aide d'une paire de clés AccessKey ou d'un jeton Security Token Service (STS). Choisissez la méthode adaptée à vos besoins métier.

Contexte

Vous pouvez initialiser les SDK ApsaraVideo VOD de deux manières. La première consiste à utiliser la paire de clés AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM disposant des autorisations requises, définies par des politiques d'autorisation. Cette paire de clés reste valide après la création du compte ou de l'utilisateur. Nous vous recommandons cette méthode pour les déploiements serveur. La seconde méthode utilise un jeton STS auquel des autorisations ont été accordées via des politiques d'autorisation. Vous pouvez définir la durée de validité du jeton STS.

Prérequis

  • Le SDK ApsaraVideo VOD pour Python est installé. Pour plus d'informations, consultez la rubrique Installation.

  • Un utilisateur RAM est créé et dispose des autorisations nécessaires. Pour plus d'informations, consultez la rubrique Créer un utilisateur RAM et lui accorder des autorisations.

  • Configurez les variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET. Pour plus d'informations, consultez la rubrique Configurer les variables d'environnement sous Linux, macOS et Windows.

    Important
    • La paire de clés AccessKey d'un compte Alibaba Cloud dispose de toutes les autorisations d'API. Utilisez la paire de clés AccessKey d'un utilisateur RAM pour appeler les API ou effectuer les opérations de maintenance courantes.

    • N'intégrez pas directement votre AccessKey ID et votre AccessKey Secret dans le code de votre projet. En cas de fuite, toutes les ressources de votre compte seraient compromises.

  • Une région est spécifiée pour l'utilisation d'ApsaraVideo VOD. Par exemple, si vous utilisez ApsaraVideo VOD dans la région Chine (Shanghai), l'ID de région est cn-shanghai. Pour plus d'informations, consultez la rubrique Centres VOD et endpoints.

Initialiser le SDK à l'aide d'une paire de clés AccessKey

Obtenez une paire de clés AccessKey pour finaliser la vérification d'identité et appeler les API ApsaraVideo VOD. Pour savoir comment obtenir une paire de clés AccessKey, consultez la rubrique Créer une paire de clés AccessKey.

Initialisez le SDK avec la paire de clés AccessKey. Exemple de code :

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

# Obtain the AccessKey information.
def init_vod_client():
    regionId = 'cn-shanghai'   # The region in which ApsaraVideo VOD is activated.
    connectTimeout = 3         # The timeout period. Unit: seconds.
    // The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M. 
    // We recommend that you do not save your AccessKey pair (AccessKey ID and AccessKey secret) in your project code. Otherwise, the AccessKey pair may be leaked. As a result, the security of all resources within your account is compromised. 
    // In this example, ApsaraVideo VOD reads the AccessKey pair from the environment variables to implement identity verification for API access. Before you run the sample code, configure the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and 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)

Initialiser le SDK à l'aide d'un jeton STS

Obtenez un jeton STS pour initialiser le SDK. Pour savoir comment obtenir un jeton STS, consultez la section « Utiliser STS pour autoriser l'accès » de la rubrique Créer un rôle et accorder des autorisations d'accès temporaires au rôle via STS.

Initialisez le SDK avec un jeton STS. Exemple de code :

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

# Obtain the STS information.
def init_vod_client(accessKeyId, accessKeySecret, securityToken):
    regionId = 'cn-shanghai'   # The region in which ApsaraVideo VOD is activated.
    connectTimeout = 3         # The timeout period. Unit: seconds.
    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)