すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud SDK:リトライメカニズム

最終更新日:Nov 09, 2025

V2.0 ソフトウェア開発キット (SDK) には、OpenAPI リクエストにおけるネットワーク例外に対する自動リトライメカニズムが組み込まれています。ネットワークの問題でリクエストが失敗した場合、システムは自動的にリクエストをリトライして、サービスの安定性と信頼性を向上させます。SDK は、無効なパラメーターや存在しないリソースなどのビジネス論理エラーが原因で失敗したリクエストはリトライしません。アプリケーションは、リクエストを再送信するのではなく、特定のエラーメッセージに基づいてこれらのエラーを処理する必要があります。このトピックでは、V2.0 SDK のネットワーク例外に対する自動リトライメカニズムを設定する方法について説明します。

リトライメカニズムの設定方法

説明

RuntimeOptions の設定は、デフォルトの設定よりも優先されます。

  • デフォルトの設定を使用します。デフォルトでは、リトライ機能は無効になっています。リトライ回数を設定せずにリトライを有効にした場合、システムはリクエストを最大 3 回リトライします。

  • com.aliyun.teautil.models.RuntimeOptions クラスを使用して、特定のリクエストのリトライメカニズムを設定します。

    com.aliyun.teautil.models.RuntimeOptions runtimeOptions = new com.aliyun.teautil.models.RuntimeOptions();
    // 自動リトライメカニズムを有効にします。
    runtimeOptions.autoretry = true;
    // 自動リトライの最大回数を設定します。
    runtimeOptions.maxAttempts = 3;