RetryOptions.MaxRetryAttemptsOnThrottledRequests Propriedade

Definição

Namespace:

Microsoft.Azure.Documents.Client

Assemblies:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Pacotes:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

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 MaxRetryAttemptsOnThrottledRequests { get; set; }

member this.MaxRetryAttemptsOnThrottledRequests : int with get, set

Public Property MaxRetryAttemptsOnThrottledRequests As Integer

Valor da propriedade

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. Para obter um exemplo sobre como definir esse valor, consulte RetryOptions.

Comentários

Quando um cliente estiver enviando solicitações mais rapidamente do que a taxa permitida, o serviço retornará HttpStatusCode 429 (Solicitação Demais) 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.