Si vous utilisez Alibaba Cloud SDK V1.0, migrez vers la V2.0 pour bénéficier d'un modèle client thread-safe, d'une prise en charge linguistique étendue et des dernières fonctionnalités API.
Faut-il migrer ?
Choisissez selon la situation de votre projet :
Projet simple, sans problème — Restez sur la V1.0. La migration n'est pas nécessaire si cette version répond à vos besoins.
Projet complexe appelant plusieurs services cloud — Migrez vers la V2.0. Cette version offre un modèle client thread-safe qui élimine les problèmes de concurrence fréquents dans les intégrations multi-services sous V1.0.
Nouveau projet — Adoptez directement la V2.0.
Compatibilité
La V2.0 n'est pas rétrocompatible avec la V1.0. Les deux versions utilisent des conventions de nommage de packages différentes et peuvent coexister au sein du même projet, ce qui permet de migrer un service à la fois.
|
Version |
Convention de nommage des packages |
Exemple (ECS) |
Exemple (VPC) |
|
V2.0 |
|
|
|
|
V1.0 |
|
|
|
La configuration Maven suivante montre comment utiliser la V1.0 et la V2.0 côte à côte. Le SDK ECS V2.0 ainsi que les packages core et ECS V1.0 sont tous deux déclarés comme dépendances afin de permettre une migration progressive service par service.
<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>Prérequis environnementaux
La V2.0 prend en charge davantage de langages de programmation que la V1.0, mais impose des exigences environnementales plus strictes. Vérifiez votre environnement d'exécution avant de migrer :
|
Langage |
Prérequis V1.0 |
Prérequis V2.0 |
|
Java |
Java 6.0 ou ultérieur |
Java 8.0 ou ultérieur |
|
Node.js |
JavaScript pris en charge |
TypeScript uniquement |
Java : La V2.0 nécessite Java 8.0 ou ultérieur, contre Java 6.0 ou ultérieur pour la V1.0.
Node.js : La V2.0 prend en charge TypeScript exclusivement. Assurez-vous que votre projet est compatible avec TypeScript avant de migrer.
Pour la configuration spécifique à chaque langage et les références API, consultez la documentation de développement correspondant à votre langage.