CosmosClientOptions.MaxRetryAttemptsOnRateLimitedRequests Propriedade

Definição

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Pacote:

Microsoft.Azure.Cosmos v3.39.0

Origem:

CosmosClientOptions.cs

Obtém ou define o número máximo de repetições no caso em que a solicitação falha porque o serviço do Azure Cosmos DB aplicou limitação de taxa ao cliente.

public int? MaxRetryAttemptsOnRateLimitedRequests { get; set; }

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

Public Property MaxRetryAttemptsOnRateLimitedRequests As Nullable(Of Integer)

Valor da propriedade

Nullable<Int32>

O valor padrão é 9. Isso significa que, no caso em que a solicitação é limitada por taxa, a mesma solicitação será emitida no máximo 10 vezes para o servidor antes que um erro seja retornado ao aplicativo.

Se o valor dessa propriedade for definido como 0, não haverá repetição automática sobre solicitações de limitação de taxa do cliente e a exceção precisará ser tratada no nível do aplicativo.

Comentários

Quando um cliente estiver enviando solicitações mais rapidamente do que a taxa permitida, o serviço retornará HttpStatusCode 429 (Muitas Solicitações) para limitar a taxa do cliente. A implementação atual no SDK aguardará a quantidade de tempo que o serviço informa para aguardar e tentar novamente depois que o tempo tiver decorrido.

Para obter mais informações, consulte Tratar a limitação de taxa/taxa de solicitação muito grande.

Confira também

• WithThrottlingRetryOptions(TimeSpan, Int32)