public sealed class RetryConfig : IMessage<RetryConfig>, IEquatable<RetryConfig>, IDeepCloneable<RetryConfig>, IBufferMessage, IMessageRetry config.
These settings determine when a failed task attempt is retried.
Implements
IMessage<RetryConfig>, IEquatable<RetryConfig>, IDeepCloneable<RetryConfig>, IBufferMessage, IMessageNamespace
Google.Cloud.Tasks.V2Beta3Assembly
Google.Cloud.Tasks.V2Beta3.dll
Constructors
RetryConfig()
public RetryConfig()RetryConfig(RetryConfig)
public RetryConfig(RetryConfig other)| Parameter | |
|---|---|
| Name | Description |
other | RetryConfig |
Properties
MaxAttempts
public int MaxAttempts { get; set; }Number of attempts per task.
Cloud Tasks will attempt the task max_attempts times (that is, if the
first attempt fails, then there will be max_attempts - 1 retries). Must
be >= -1.
If unspecified when the queue is created, Cloud Tasks will pick the default.
-1 indicates unlimited attempts.
This field has the same meaning as task_retry_limit in queue.yaml/xml.
| Property Value | |
|---|---|
| Type | Description |
Int32 | |
MaxBackoff
public Duration MaxBackoff { get; set; }A task will be [scheduled][google.cloud.tasks.v2beta3.Task.schedule_time] for retry between [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff] and [max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] duration after it fails, if the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] specifies that the task should be retried.
If unspecified when the queue is created, Cloud Tasks will pick the default.
max_backoff will be truncated to the nearest second.
This field has the same meaning as max_backoff_seconds in queue.yaml/xml.
| Property Value | |
|---|---|
| Type | Description |
Duration | |
MaxDoublings
public int MaxDoublings { get; set; }The time between retries will double max_doublings times.
A task's retry interval starts at
[min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff], then doubles
max_doublings times, then increases linearly, and finally
retries at intervals of
[max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] up to
[max_attempts][google.cloud.tasks.v2beta3.RetryConfig.max_attempts] times.
For example, if [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff] is 10s,
[max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] is 300s, and
max_doublings is 3, then the a task will first be retried in
10s. The retry interval will double three times, and then
increase linearly by 2^3 * 10s. Finally, the task will retry at
intervals of [max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] until the
task has been attempted [max_attempts][google.cloud.tasks.v2beta3.RetryConfig.max_attempts]
times. Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s,
240s, 300s, 300s, ....
If unspecified when the queue is created, Cloud Tasks will pick the default.
This field has the same meaning as max_doublings in queue.yaml/xml.
| Property Value | |
|---|---|
| Type | Description |
Int32 | |
MaxRetryDuration
public Duration MaxRetryDuration { get; set; }If positive, max_retry_duration specifies the time limit for
retrying a failed task, measured from when the task was first
attempted. Once max_retry_duration time has passed and the
task has been attempted [max_attempts][google.cloud.tasks.v2beta3.RetryConfig.max_attempts]
times, no further attempts will be made and the task will be
deleted.
If zero, then the task age is unlimited.
If unspecified when the queue is created, Cloud Tasks will pick the default.
max_retry_duration will be truncated to the nearest second.
This field has the same meaning as task_age_limit in queue.yaml/xml.
| Property Value | |
|---|---|
| Type | Description |
Duration | |
MinBackoff
public Duration MinBackoff { get; set; }A task will be [scheduled][google.cloud.tasks.v2beta3.Task.schedule_time] for retry between [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff] and [max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] duration after it fails, if the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] specifies that the task should be retried.
If unspecified when the queue is created, Cloud Tasks will pick the default.
min_backoff will be truncated to the nearest second.
This field has the same meaning as min_backoff_seconds in queue.yaml/xml.
| Property Value | |
|---|---|
| Type | Description |
Duration | |