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

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

最終更新日:Nov 09, 2025

Alibaba Cloud SDK V2.0 では、API リクエスト処理ロジックに、ネットワーク例外に対する組み込みの再試行ロジックが含まれています。ネットワーク例外が原因でリクエストが失敗した場合、システムはサービスの安定性と信頼性を確保するために、リクエストを自動的に再試行して再起動します。ただし、パラメーターエラーやリソースの不足など、ビジネスロジックエラーが原因でリクエストが失敗した場合、システムは再試行を実行しません。この場合、再試行を実行する代わりに、対応するエラーメッセージに基づいてリクエストを調整する必要があります。このトピックでは、Alibaba Cloud SDK V2.0 for Node.js で再試行メカニズムを構成する方法について説明します。

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

説明

再試行メカニズムの構成に使用されるメソッドの優先順位レベルは、RuntimeOptions > デフォルトの再試行設定の順に降順です。

  • デフォルトの再試行設定を使用することをお勧めします。デフォルトでは、例外が発生した場合、再試行は実行されません。自動再試行メカニズムを有効にしても最大再試行回数を指定しない場合、デフォルトで最大 3 回の再試行が実行されます。

  • RuntimeOptions を使用してリトライメカニズムを設定します。

    const { RuntimeOptions } = require('@alicloud/tea-util');
    
    // RuntimeOptions インスタンスを作成し、実行時パラメーターを設定します。
    const runtime = new RuntimeOptions({
      // 自動リトライを有効にします。
      autoretry: true,
      // リトライ回数を設定します。
      maxAttempts: 3,
    });
    
    import * as $Util from '@alicloud/tea-util';
    
    // RuntimeOptions インスタンスを作成し、実行時パラメーターを設定します。
    const runtime = new $Util.RuntimeOptions({
      // 自動リトライを有効にします。
      autoretry: true,
      // リトライ回数を設定します。
      maxAttempts: 3,
    });