SDK Java V2.0 (recomendado) - Alibaba Cloud SDK: Central de Documentação do Alibaba Cloud

Conheça os pacotes de dependência comuns e as classes de configuração do SDK V2.0 para resolver erros rapidamente e aumentar a eficiência do desenvolvimento.

Pacotes de dependência comuns

A maioria dos produtos em nuvem no SDK V2.0 exige os seguintes pacotes de dependência comuns. Obtenha as versões mais recentes no repositório Maven. Em caso de conflitos de pacotes, adicione manualmente as versões mais recentes ao seu projeto.

Nota

Esses pacotes são instalados automaticamente com o SDK do produto em nuvem. Se ocorrer um erro, adicione manualmente a versão mais recente.

Nome do pacote	Endereço no Maven	Endereço do repositório de código no GitHub
tea-util	Maven Central: com.aliyun:tea-util	tea-util
tea	Maven Central: com.aliyun:tea	tea-java
credentials-java	Maven Central: com.aliyun:credentials-java	credentials-java
credentials-api	Maven Central: com.aliyun:credentials-api	credentials-api
openapiutil	Maven Central: com.aliyun:openapiutil	openapiutil
alibabacloud-gateway-spi	Maven Central: com.aliyun:alibabacloud-gateway-spi	alibabacloud-gateway-spi
tea-xml	Maven Central: com.aliyun:tea-xml	tea-xml
tea-openapi	Maven Central: com.aliyun:tea-openapi	tea-openapi

Classes de configuração

com.aliyun.teaopenapi.models.Config

Use esta classe para configurar parâmetros globais, como credenciais, endpoints, configurações de proxy e timeouts. A tabela a seguir descreve os parâmetros.

Nota

Não use parâmetros fora da tabela. Eles podem estar obsoletos ou não ter efeito.

Nome do parâmetro	Descrição
credential	Cliente de credenciais. No SDK V2.0, a ferramenta de credenciais gerencia as informações de credenciais. Para obter mais informações, consulte Gerenciar credenciais de acesso.
accessKeyId	AccessKey ID. Defina este parâmetro ou `credential`. Se ambos `credential` e `accessKeyId` forem definidos, o sistema usará as credenciais em `credential`.
accessKeySecret	AccessKey secret. Defina este parâmetro ou `credential`. Se ambos `credential` e `accessKeySecret` forem definidos, o sistema usará as credenciais em `credential`.
securityToken	Token do Security Token Service (STS). Defina este parâmetro ou `credential`. Se ambos `credential` e `securityToken` forem definidos, o sistema usará as credenciais em `credential`.
bearerToken	Bearer token. Defina este parâmetro ou `credential`. Se ambos `credential` e `bearerToken` forem definidos, o sistema usará as credenciais em `credential`.
endpoint	Endpoint de serviço da região onde residem seus recursos em nuvem. As chamadas de API são roteadas por meio deste endpoint. Para obter mais informações, consulte Configurar endpoints.
regionId	Região onde residem seus recursos em nuvem. Se `endpoint` não estiver definido, o SDK resolverá o endpoint de serviço a partir deste ID de região. Para obter mais informações, consulte Configurar endpoints.
network	Quando `regionId` está definido, especifica o tipo de endpoint a ser resolvido. Por padrão, usa-se um endpoint de Internet. Valores válidos: `vpc`: resolve um endpoint de VPC. Para o SDK do Simple Log Service (sls20201230), um endpoint de Internet é usado por padrão. É possível especificar um tipo diferente de endpoint: `intranet`: resolve o endpoint de VPC para o Simple Log Service. `accelerate`: resolve o endpoint de aceleração de transferência para o Simple Log Service.
maxIdleConns	Número máximo de conexões ociosas no pool de conexões. O sistema fecha conexões ociosas excedentes para liberar recursos. Valor padrão: 5. Para obter mais informações, consulte Configurar um pool de conexões HTTP.
protocol	Protocolo da solicitação. Valores válidos: HTTPS e HTTP. Valor padrão: HTTPS. Para obter mais informações, consulte Configurar solicitações HTTPS.
readTimeout	Tempo limite de leitura. Valor padrão: 10000 milissegundos. Para obter mais informações, consulte Mecanismo de timeout.
connectTimeout	Tempo limite de conexão. Valor padrão: 5000 milissegundos. Para obter mais informações, consulte Mecanismo de timeout.
httpProxy	Endereço e porta do servidor proxy HTTP. Formato: `http://proxyServer:port`. Para obter mais informações, consulte Configurar um proxy.
httpsProxy	Endereço e porta do servidor proxy HTTPS. Formato: `https://username:password@proxyServer:port`. Se a autenticação de proxy não for necessária, use `https://proxyServer:port`. Para obter mais informações, consulte Configurar um proxy.
noProxy	Lista de endereços separados por vírgulas que ignoram o proxy. Há suporte para nomes de domínio e endereços IP. Para obter mais informações, consulte Configurar um proxy.

com.aliyun.teautil.models.RuntimeOptions

Esta classe permite configurar parâmetros de runtime por solicitação, como configurações de proxy e timeout. A tabela a seguir descreve os parâmetros.

Nota

Não use parâmetros fora da tabela. Eles podem estar obsoletos ou não ter efeito.

Nome do parâmetro	Descrição
autoretry	Defina se as tentativas automáticas devem ser ativadas para erros de rede. Valor padrão: `false` (desativado). Para obter mais informações, consulte Mecanismo de nova tentativa.
maxAttempts	Número máximo de tentativas quando as retentativas automáticas estão ativadas. Valor padrão: 3. Para obter mais informações, consulte Mecanismo de nova tentativa.
maxIdleConns	Limite de conexões ociosas no pool de conexões. O sistema encerra conexões excedentes para liberar recursos. Valor padrão: 5. Para obter mais informações, consulte Configurar um pool de conexões HTTP.
ignoreSSL	Quando `protocol` está definido como HTTPS, o SDK valida certificados SSL/TLS por padrão. Caso seu ambiente não possua um certificado SSL/TLS, use este parâmetro para pular a validação temporariamente. Valor padrão: `false` (validação obrigatória). Para obter mais informações, consulte Configurar solicitações HTTPS. Nota Para garantir a segurança da comunicação em seu ambiente de produção, ative a validação de certificados.
readTimeout	Tempo limite de leitura. Valor padrão: 10000 milissegundos. Para obter mais informações, consulte Mecanismo de timeout.
connectTimeout	Tempo limite de conexão. Valor padrão: 5000 milissegundos. Para obter mais informações, consulte Mecanismo de timeout.
httpProxy	Endereço e porta do servidor proxy HTTP. Formato: `http://proxyServer:port`. Para obter mais informações, consulte Configurar um proxy.
httpsProxy	Endereço e porta do servidor proxy HTTPS. Formato: `https://username:password@proxyServer:port`. Caso não seja necessária autenticação no proxy, use `https://proxyServer:port`. Para obter mais informações, consulte Configurar um proxy.
noProxy	Lista de endereços separados por vírgula que não passam pelo proxy. Há suporte para nomes de domínio e endereços IP. Para obter mais informações, consulte Configurar um proxy.