Inicializar o SDK do ApsaraVideo VOD para Java - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

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

Informações básicas

É possível inicializar os SDKs do ApsaraVideo VOD de duas formas. Utilize o par de AccessKey de uma conta Alibaba Cloud ou de um usuário RAM com as permissões necessárias, concedidas por políticas de autorização. Esse par de AccessKey permanece válido após a criação da conta Alibaba Cloud ou do usuário RAM. Recomendamos esse método para uso no servidor. Alternativamente, inicialize o SDK com um token STS que tenha as permissões adequadas, também definidas por políticas de autorização. Nesse caso, você pode especificar o período de validade do token STS.

Pré-requisitos

SDK do ApsaraVideo VOD para Java instalado. Para mais informações, consulte Instalar o SDK do ApsaraVideo VOD para Java.
Usuário RAM criado e com as permissões necessárias concedidas. Para mais informações, consulte Criar um usuário RAM e conceder permissões.
Variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET configuradas. Para mais informações, consulte Configurar variáveis de ambiente no Linux, macOS e Windows.
Importante
- O par de AccessKey de uma conta Alibaba Cloud tem permissão em todas as operações de API. Utilize 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 diretamente seu AccessKey ID e AccessKey secret no código do projeto. Em caso de vazamento, todos os recursos da sua conta ficarão comprometidos.
Região definida para o uso do ApsaraVideo VOD. Por exemplo, se você utilizar o serviço na região China (Shanghai), o ID da região será cn-shanghai. Para mais informações, consulte Centros e endpoints do VOD.

Inicializar com um par de AccessKey

Obtenha um par de AccessKey para concluir a verificação de identidade e chamar operações de API do ApsaraVideo VOD. Para saber como obter um par de AccessKey, consulte Criar um par de AccessKey.

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 obter instruções sobre como conseguir esse token, consulte a seção "Usar STS para autorizar acesso" no tópico Criar uma função e conceder permissões de acesso temporário à função usando 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;
}