Alibaba Cloud SDK:Alibaba Cloud SDK V1.0 から V2.0 へのアップグレード

Alibaba Cloud SDK V2.0 は必須ですか？

Alibaba Cloud SDK V1.0 を使用して単純なシナリオでクラウドサービスを統合し、問題が発生していない場合は、Alibaba Cloud SDK V1.0 を V2.0 にすぐにアップグレードしないことをお勧めします。

Alibaba Cloud SDK V1.0 を使用して複雑なシナリオで複数のクラウドサービスの API オペレーションを呼び出し、スレッドセーフティの問題を考慮する必要がある場合は、Alibaba Cloud SDK V1.0 を V2.0 にアップグレードすることを強くお勧めします。

新しいプロジェクトのテクノロジーを選択する場合は、Alibaba Cloud SDK V2.0 を直接使用することを強くお勧めします。

互換性

Alibaba Cloud SDK V2.0 は Alibaba Cloud SDK V1.0 と互換性がありません。SDK V1.0 を V2.0 にアップグレードするには、依存関係を追加するときに SDK 名を変更します。このようにして、後続の開発で SDK V2.0 を使用できます。

Alibaba Cloud SDK V2.0 は、${Service name}${API version number} 形式で名前が付けられます。たとえば、Elastic Compute Service（ECS）の SDK V2.0 は com.aliyun:ecs20140526 という名前で、Virtual Private Cloud（VPC）の SDK V2.0 は com.aliyun:vpc20160428 という名前です。

Alibaba Cloud SDK V1.0 は、aliyun-${Language}-sdk-${Service name} 形式で名前が付けられます。たとえば、ECS の SDK V1.0 は com.aliyun:aiyun-java-sdk-ecs という名前で、VPC の SDK V1.0 は com.aliyun:aliyun-java-sdk-vpc という名前です。

次のサンプルコードは、SDK をアップグレードするために Maven の依存関係を追加する方法を示しています。この例では、ECS の SDK V2.0 と SDK V1.0 が使用されています。依存関係を追加した後、後続の開発で SDK V2.0 を使用できます。

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

使用上の注意

Alibaba Cloud SDK V2.0 は、Alibaba Cloud SDK V1.0 よりも多くのプログラミング言語をサポートしていますが、環境とフレームワークの要件があります。例：

• Java 用の Alibaba Cloud SDK V2.0 は Java 8.0 以降が必要ですが、Java 用の Alibaba Cloud SDK V1.0 は Java 6.0 以降が必要です。

• Node.js 用の Alibaba Cloud SDK V2.0 は TypeScript のみサポートしています。この SDK を使用するには、プロジェクトも TypeScript をサポートしている必要があります。

詳細については、使用している言語の開発ドキュメントをご参照ください。