Class RateLimitingOptions

Namespace

Cloudflare.NET.Core

Assembly

Cloudflare.NET.dll

Configures the automatic retry policy for rate-limited requests (HTTP 429).

public class RateLimitingOptions

Inheritance

object

RateLimitingOptions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Properties

EnableProactiveThrottling

Gets or sets a value indicating whether proactive throttling based on server rate limit headers is enabled. When enabled, the client will automatically delay requests when the remaining quota falls below the threshold, preventing 429 responses before they occur. Defaults to true.

public bool EnableProactiveThrottling { get; set; }

Property Value

bool

IsEnabled

Gets or sets a value indicating whether automatic rate-limit handling is enabled. Defaults to false.

public bool IsEnabled { get; set; }

Property Value

bool

MaxRetries

Gets or sets the maximum number of retries for a rate-limited request. Defaults to 2.

public int MaxRetries { get; set; }

Property Value

int

PermitLimit

Gets or sets the maximum number of concurrent requests allowed by the client-side rate limiter. Defaults to 25. This helps prevent sending a burst of requests that would trigger a 429 response.

public int PermitLimit { get; set; }

Property Value

int

QueueLimit

Gets or sets the number of requests that can be queued when the concurrency limit is reached. Defaults to 50.

public int QueueLimit { get; set; }

Property Value

int

QuotaLowThreshold

Gets or sets the threshold (0.0 to 1.0) at which proactive throttling begins. For example, 0.1 means throttling starts when only 10% of the quota remains. Defaults to 0.1 (10%).

public double QuotaLowThreshold { get; set; }

Property Value

double