次の方法で共有


RetryOptions クラス

  • java.lang.Object
    • com.microsoft.azure.cosmosdb.RetryOptions

public class RetryOptions

Azure Cosmos DB データベース サービスの再試行オプションをカプセル化します。

コンストラクターの概要

コンストラクター 説明
RetryOptions()

RetryOptions クラスの新しいインスタンスを作成し、すべてのプロパティを既定値に初期化します。

メソッドの概要

修飾子と型 メソッドと説明
int getMaxRetryAttemptsOnThrottledRequests()

サービスがクライアントにレート制限を適用したために要求が失敗した場合の最大再試行回数を取得します。

int getMaxRetryWaitTimeInSeconds()

最大再試行時間 (秒単位) を取得します。

void setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests)

サービスがクライアントにレート制限を適用したために要求が失敗した場合の再試行の最大数を設定します。

クライアントが許可されたレートよりも速く要求を送信している場合、サービスは HttpStatusCode 429 (要求が多すぎます) を返してクライアントを調整します。 SDK の現在の実装では、時間が経過した後にサービスから待機と再試行が指示された時間を待機します。

既定値は 9 です。 つまり、要求が調整された場合、アプリケーションにエラーが返される前に、サーバーに対して同じ要求が最大 10 回発行されます。

void setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds)

最大再試行時間を秒単位で設定します。

スロットル エラーが原因で要求が失敗した場合、サービスは、クライアントが期間が経過する前に再試行しないことを示す値 (Retry-After) を含む応答を返します。 MaxRetryWaitTime フラグを使用すると、アプリケーションはすべての再試行の最大待機時間を設定できます。 累積待機時間が MaxRetryWaitTime を超えると、SDK は再試行を停止し、エラーをアプリケーションに返します。

既定値は 30 秒です。

String toString()

コンストラクターの詳細

RetryOptions

public RetryOptions()

RetryOptions クラスの新しいインスタンスを作成し、すべてのプロパティを既定値に初期化します。

メソッドの詳細

getMaxRetryAttemptsOnThrottledRequests

public int getMaxRetryAttemptsOnThrottledRequests()

サービスがクライアントにレート制限を適用したために要求が失敗した場合の最大再試行回数を取得します。

戻り値:

再試行の最大数。

getMaxRetryWaitTimeInSeconds

public int getMaxRetryWaitTimeInSeconds()

最大再試行時間 (秒単位) を取得します。

戻り値:

最大再試行時間 (秒単位)。

setMaxRetryAttemptsOnThrottledRequests

public void setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests)

サービスがクライアントにレート制限を適用したために要求が失敗した場合の再試行の最大数を設定します。

クライアントが許可されたレートよりも速く要求を送信している場合、サービスは HttpStatusCode 429 (要求が多すぎます) を返してクライアントを調整します。 SDK の現在の実装では、時間が経過した後にサービスから待機と再試行が指示された時間を待機します。

既定値は 9 です。 つまり、要求が調整された場合、アプリケーションにエラーが返される前に、サーバーに対して同じ要求が最大 10 回発行されます。

パラメーター:

maxRetryAttemptsOnThrottledRequests - スロットル エラーが原因で失敗した要求に対する再試行の最大数。

setMaxRetryWaitTimeInSeconds

public void setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds)

最大再試行時間を秒単位で設定します。

スロットル エラーが原因で要求が失敗した場合、サービスは、クライアントが期間が経過する前に再試行しないことを示す値 (Retry-After) を含む応答を返します。 MaxRetryWaitTime フラグを使用すると、アプリケーションはすべての再試行の最大待機時間を設定できます。 累積待機時間が MaxRetryWaitTime を超えると、SDK は再試行を停止し、エラーをアプリケーションに返します。

既定値は 30 秒です。

パラメーター:

maxRetryWaitTimeInSeconds - 要求が再試行される最大秒数。

toString

public String toString()

適用対象