ApsaraVideo VOD:Initialiser le SDK Java

Contexte

Vous disposez de deux méthodes pour initialiser les SDK ApsaraVideo VOD. La première utilise 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 environnements serveur. La seconde méthode utilise un jeton STS auquel des autorisations appropriées ont été attribuées via des politiques d'autorisation. Vous pouvez définir la durée de validité de ce jeton STS.

Prérequis

• Le SDK ApsaraVideo VOD pour Java est installé. Pour plus d'informations, consultez la rubrique Installer le SDK ApsaraVideo VOD pour Java.

• 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 d'autorisations sur toutes les opérations d'API. Utilisez la paire de clés AccessKey d'un utilisateur RAM pour appeler les opérations d'API ou effectuer les tâches courantes d'exploitation et de maintenance (O&M).

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

• Spécifiez une région pour utiliser 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.

Initialisation avec 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.

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

// Obtain the AccessKey information.
public static DefaultAcsClient initVodClient() throws ClientException {
    String regionId = "cn-shanghai";  // Specify the region in which ApsaraVideo VOD is activated.
    // 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 not include your AccessKey pair (AccessKey ID and AccessKey secret) in your project code. Otherwise, the AccessKey pair may be leaked and the security of all resources within your account may be 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. 
    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;
}

Initialisation avec 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.

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

// Obtain the STS information.
public static DefaultAcsClient initVodClient() throws ClientException {
    String regionId = "cn-shanghai";  // Specify the region in which ApsaraVideo VOD is activated.
    DefaultProfile profile = DefaultProfile.getProfile(
            regionId,           				                // The region ID
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),       // The AccessKey ID of the RAM account
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),   // The AccessKey Secret of the RAM account
            System.getenv("ALIBABA_CLOUD_SECURITY_TOKEN"));     // STS Token
    DefaultAcsClient client = new DefaultAcsClient(profile);
    return client;
}