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

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

最終更新日:Oct 10, 2025

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

設定方法

説明

設定の優先度は、高いものから順に RuntimeOptions の設定、デフォルト設定となります。

  • デフォルト設定を使用します。デフォルトでは、リクエストはリトライされません。リトライを有効にしても試行回数を指定しない場合、システムは失敗したリクエストを最大 3 回リトライします。

  • 実行時パラメーター (RuntimeOptions) を使用してリトライを設定します。

    use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
    
    // 実行時パラメーターを設定します。この設定は、この RuntimeOptions インスタンスを使用するリクエストにのみ有効です。
    $runtime = new RuntimeOptions([
        "autoretry" => true, // リトライを有効にします。
        "maxAttempts" => 3, // 最大リトライ回数。
    ]);