你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

RetryOptions 类

参考

包:: com.microsoft.azure.cosmosdb

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) 设置最大重试时间（以秒为单位）。当请求因限制错误而失败时，服务会发送一个响应，其中包含一个值，该值指示客户端不应在经过时间段之前重试 (在) 之后重试。 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)

设置最大重试时间（以秒为单位）。

当请求因限制错误而失败时，服务会发送一个响应，其中包含一个值，该值指示客户端不应在经过时间段之前重试 (在) 之后重试。 MaxRetryWaitTime 标志允许应用程序为所有重试尝试设置最长等待时间。如果累积等待时间超过 MaxRetryWaitTime，SDK 将停止重试并将错误返回给应用程序。

默认值为 30 秒。

参数:

maxRetryWaitTimeInSeconds - 请求重试的最大秒数。

toString

public String toString()

通过