Class RetryConfig (2.3.0)

public sealed class RetryConfig : IMessage<RetryConfig>, IEquatable<RetryConfig>, IDeepCloneable<RetryConfig>, IBufferMessage, IMessage

Settings that determine the retry behavior.

By default, if a job does not complete successfully (meaning that an acknowledgement is not received from the handler, then it will be retried with exponential backoff according to the settings in [RetryConfig][google.cloud.scheduler.v1.RetryConfig].

Inheritance

Object > RetryConfig

Namespace

Google.Cloud.Scheduler.V1

Assembly

Google.Cloud.Scheduler.V1.dll

Constructors

RetryConfig()

public RetryConfig()

RetryConfig(RetryConfig)

public RetryConfig(RetryConfig other)
Parameter
NameDescription
otherRetryConfig

Properties

MaxBackoffDuration

public Duration MaxBackoffDuration { get; set; }

The maximum amount of time to wait before retrying a job after it fails.

The default value of this field is 1 hour.

Property Value
TypeDescription
Duration

MaxDoublings

public int MaxDoublings { get; set; }

The time between retries will double max_doublings times.

A job's retry interval starts at [min_backoff_duration][google.cloud.scheduler.v1.RetryConfig.min_backoff_duration], then doubles max_doublings times, then increases linearly, and finally retries retries at intervals of [max_backoff_duration][google.cloud.scheduler.v1.RetryConfig.max_backoff_duration] up to [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count] times.

For example, if [min_backoff_duration][google.cloud.scheduler.v1.RetryConfig.min_backoff_duration] is 10s, [max_backoff_duration][google.cloud.scheduler.v1.RetryConfig.max_backoff_duration] is 300s, and max_doublings is 3, then the a job will first be retried in 10s. The retry interval will double three times, and then increase linearly by 2^3 * 10s. Finally, the job will retry at intervals of [max_backoff_duration][google.cloud.scheduler.v1.RetryConfig.max_backoff_duration] until the job has been attempted [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count] times. Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, ....

The default value of this field is 5.

Property Value
TypeDescription
Int32

MaxRetryDuration

public Duration MaxRetryDuration { get; set; }

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count], the job will be retried until both limits are reached.

The default value for max_retry_duration is zero, which means retry duration is unlimited.

Property Value
TypeDescription
Duration

MinBackoffDuration

public Duration MinBackoffDuration { get; set; }

The minimum amount of time to wait before retrying a job after it fails.

The default value of this field is 5 seconds.

Property Value
TypeDescription
Duration

RetryCount

public int RetryCount { get; set; }

The number of attempts that the system will make to run a job using the exponential backoff procedure described by [max_doublings][google.cloud.scheduler.v1.RetryConfig.max_doublings].

The default value of retry_count is zero.

If retry_count is zero, a job attempt will not be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time.

If retry_count is set to a non-zero number then Cloud Scheduler will retry failed attempts, using exponential backoff, retry_count times, or until the next scheduled execution time, whichever comes first.

Values greater than 5 and negative values are not allowed.

Property Value
TypeDescription
Int32