public sealed class RetryConfig : IMessage<RetryConfig>, IEquatable<RetryConfig>, IDeepCloneable<RetryConfig>, IBufferMessage, IMessageSettings 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].
Implements
IMessage<RetryConfig>, IEquatable<RetryConfig>, IDeepCloneable<RetryConfig>, IBufferMessage, IMessageNamespace
Google.Cloud.Scheduler.V1Assembly
Google.Cloud.Scheduler.V1.dll
Constructors
RetryConfig()
public RetryConfig()RetryConfig(RetryConfig)
public RetryConfig(RetryConfig other)| Parameter | |
|---|---|
| Name | Description |
other | RetryConfig |
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 | |
|---|---|
| Type | Description |
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 | |
|---|---|
| Type | Description |
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 | |
|---|---|
| Type | Description |
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 | |
|---|---|
| Type | Description |
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 | |
|---|---|
| Type | Description |
Int32 | |