Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Inicializar o SDK para Java

Última atualização: Sep 22, 2026

Inicialize o SDK do ApsaraVideo VOD para Java usando um par de AccessKey ou um token STS.

Informações de contexto

Os SDKs do ApsaraVideo VOD podem ser inicializados de duas maneiras diferentes. Inicialize o SDK usando o par de AccessKey de uma conta Alibaba Cloud ou de um usuário RAM que tenha as permissões necessárias concedidas por políticas de autorização. O par de AccessKey permanece válido após a criação da conta Alibaba Cloud ou do usuário RAM. Recomendamos usar este método no servidor. Como alternativa, inicialize o SDK usando um token STS com as permissões necessárias concedidas por políticas de autorização. Especifique o período de validade do token STS.

Pré-requisitos

  • Instale o SDK do ApsaraVideo VOD para Java. Para mais informações, consulte Install the ApsaraVideo VOD SDK for Java.

  • Crie um usuário RAM e conceda as permissões necessárias. Para mais informações, consulte Create a RAM user and grant permissions.

  • Configure as variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET. Para mais informações, consulte Configure environment variables on Linux, macOS, and Windows.

    Importante
    • O par de AccessKey de uma conta Alibaba Cloud tem permissões para todas as operações de API. Use o par de AccessKey de um usuário RAM para chamar operações de API ou executar tarefas rotineiras de O&M.

    • Não codifique seu AccessKey ID e AccessKey secret diretamente no código do projeto. Em caso de vazamento, todos os recursos da sua conta ficarão comprometidos.

  • Especifique uma região para usar o ApsaraVideo VOD. Por exemplo, se você usar o ApsaraVideo VOD na região China (Shanghai), o ID da região é cn-shanghai. Para mais informações, consulte VOD centers and endpoints.

Inicializar com um par de AccessKey

Obtenha um par de AccessKey para concluir a verificação de identidade e chamar as operações de API do ApsaraVideo VOD. Para mais informações sobre como obter um par de AccessKey, consulte Create an AccessKey pair.

Código de exemplo:

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;
}

Inicializar com um token STS

Obtenha um token STS para inicializar o SDK. Para mais informações sobre como obter um token STS, consulte a seção "Use STS to authorize access" do tópico Create a role and grant temporary access permissions to the role by using STS.

Código de exemplo:

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;
}