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

CosmosClientOptions.MaxRetryAttemptsOnRateLimitedRequests 属性

定义

命名空间:

Microsoft.Azure.Cosmos

程序集:

Microsoft.Azure.Cosmos.Client.dll

包:

Microsoft.Azure.Cosmos v3.39.0

Source:

CosmosClientOptions.cs

获取或设置在请求失败的情况下的最大重试次数，因为 Azure Cosmos DB 服务已对客户端应用速率限制。

public int? MaxRetryAttemptsOnRateLimitedRequests { get; set; }

member this.MaxRetryAttemptsOnRateLimitedRequests : Nullable<int> with get, set

Public Property MaxRetryAttemptsOnRateLimitedRequests As Nullable(Of Integer)

属性值

Nullable<Int32>

默认值为 9。 这意味着，在请求速率受限的情况下，在将错误返回到应用程序之前，将向服务器发出最多 10 次相同的请求。

如果此属性的值设置为 0，则不会自动重试来自客户端的速率限制请求，需要在应用程序级别处理异常。

注解

当客户端发送请求的速度快于允许的速率时，服务将返回 HttpStatusCode 429 (请求过多) 客户端速率限制。 然后，SDK 中的当前实现将等待服务告知其等待的时间量，并在经过该时间后重试。

有关详细信息，请参阅 处理速率限制/请求速率过大。

另请参阅

• WithThrottlingRetryOptions(TimeSpan, Int32)