Upgrade Alibaba Cloud SDK V1.0 to V2.0 - Alibaba Cloud SDK: Central de Documentação do Alibaba Cloud

Se você usa o Alibaba Cloud SDK V1.0, atualize para a V2.0 para obter um modelo de cliente thread-safe, suporte ampliado a linguagens e acesso aos recursos mais recentes da API.

Devo atualizar?

Escolha com base na situação do seu projeto:

Projeto simples, sem problemas — Permaneça na V1.0. A atualização é desnecessária se a V1.0 atender às suas necessidades.
Projeto complexo que chama vários serviços de nuvem — Atualize para a V2.0. Essa versão oferece um modelo de cliente thread-safe e elimina problemas de concorrência comuns em integrações V1.0 com múltiplos serviços.
Novo projeto — Use diretamente a V2.0.

Compatibilidade

A V2.0 não é compatível com versões anteriores da V1.0. As duas versões usam convenções de nomenclatura de pacotes diferentes e podem coexistir no mesmo projeto. Isso permite migrar um serviço por vez.

Versão	Convenção de nomenclatura de pacotes	Exemplo (ECS)	Exemplo (VPC)
V2.0	`${Service name}${API version number}`	`com.aliyun:ecs20140526`	`com.aliyun:vpc20160428`
V1.0	`aliyun-${Language}-sdk-${Service name}`	`com.aliyun:aliyun-java-sdk-ecs`	`com.aliyun:aliyun-java-sdk-vpc`

A configuração do Maven a seguir mostra como executar a V1.0 e a V2.0 simultaneamente. O exemplo declara como dependências tanto o SDK ECS V2.0 quanto os pacotes core e ECS da V1.0, o que permite migrar um serviço por vez.

<dependencies>
  <!--  V2.0 SDK  -->
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>ecs20140526</artifactId>
    <version>3.1.12</version>
  </dependency>
  <!--  V1.0 SDK  -->
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.6.3</version>
  </dependency>
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-ecs</artifactId>
    <version>4.24.59</version>
  </dependency>
</dependencies>

Requisitos de ambiente

A V2.0 suporta mais linguagens de programação que a V1.0, mas impõe requisitos de ambiente mais rigorosos. Verifique seu runtime antes de atualizar:

Linguagem	Requisito da V1.0	Requisito da V2.0
Java	Java 6.0 ou posterior	Java 8.0 ou posterior
Node.js	Suporte a JavaScript	Somente TypeScript

Java: A V2.0 requer Java 8.0 ou posterior. A V1.0 requer Java 6.0 ou posterior.
Node.js: A V2.0 suporta apenas TypeScript. Certifique-se de que seu projeto seja compatível com TypeScript antes de atualizar.

Para configuração específica da linguagem e referências da API, consulte a documentação de desenvolvimento correspondente à sua linguagem.