Class RetryConfig.Builder (2.34.0)

public static final class RetryConfig.Builder extends GeneratedMessageV3.Builder<RetryConfig.Builder> implements RetryConfigOrBuilder

Retry config.

These settings determine how a failed task attempt is retried.

Protobuf type google.cloud.tasks.v2beta2.RetryConfig

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public RetryConfig.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
RetryConfig.Builder
Overrides

build()

public RetryConfig build()
Returns
TypeDescription
RetryConfig

buildPartial()

public RetryConfig buildPartial()
Returns
TypeDescription
RetryConfig

clear()

public RetryConfig.Builder clear()
Returns
TypeDescription
RetryConfig.Builder
Overrides

clearField(Descriptors.FieldDescriptor field)

public RetryConfig.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
RetryConfig.Builder
Overrides

clearMaxAttempts()

public RetryConfig.Builder clearMaxAttempts()

The maximum number of attempts for a 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 > 0.

int32 max_attempts = 1;

Returns
TypeDescription
RetryConfig.Builder

This builder for chaining.

clearMaxBackoff()

public RetryConfig.Builder clearMaxBackoff()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Returns
TypeDescription
RetryConfig.Builder

clearMaxDoublings()

public RetryConfig.Builder clearMaxDoublings()

The time between retries will double max_doublings times.

A task's retry interval starts at min_backoff, then doubles max_doublings times, then increases linearly, and finally retries at intervals of max_backoff up to max_attempts times.

For example, if min_backoff is 10s, 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 until the task has been attempted 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 is output only for pull queues.

This field has the same meaning as max_doublings in queue.yaml/xml.

int32 max_doublings = 6;

Returns
TypeDescription
RetryConfig.Builder

This builder for chaining.

clearMaxRetryDuration()

public RetryConfig.Builder clearMaxRetryDuration()

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Returns
TypeDescription
RetryConfig.Builder

clearMinBackoff()

public RetryConfig.Builder clearMinBackoff()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Returns
TypeDescription
RetryConfig.Builder

clearNumAttempts()

public RetryConfig.Builder clearNumAttempts()
Returns
TypeDescription
RetryConfig.Builder

clearOneof(Descriptors.OneofDescriptor oneof)

public RetryConfig.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
RetryConfig.Builder
Overrides

clearUnlimitedAttempts()

public RetryConfig.Builder clearUnlimitedAttempts()

If true, then the number of attempts is unlimited.

bool unlimited_attempts = 2;

Returns
TypeDescription
RetryConfig.Builder

This builder for chaining.

clone()

public RetryConfig.Builder clone()
Returns
TypeDescription
RetryConfig.Builder
Overrides

getDefaultInstanceForType()

public RetryConfig getDefaultInstanceForType()
Returns
TypeDescription
RetryConfig

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getMaxAttempts()

public int getMaxAttempts()

The maximum number of attempts for a 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 > 0.

int32 max_attempts = 1;

Returns
TypeDescription
int

The maxAttempts.

getMaxBackoff()

public Duration getMaxBackoff()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Returns
TypeDescription
Duration

The maxBackoff.

getMaxBackoffBuilder()

public Duration.Builder getMaxBackoffBuilder()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Returns
TypeDescription
Builder

getMaxBackoffOrBuilder()

public DurationOrBuilder getMaxBackoffOrBuilder()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Returns
TypeDescription
DurationOrBuilder

getMaxDoublings()

public int getMaxDoublings()

The time between retries will double max_doublings times.

A task's retry interval starts at min_backoff, then doubles max_doublings times, then increases linearly, and finally retries at intervals of max_backoff up to max_attempts times.

For example, if min_backoff is 10s, 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 until the task has been attempted 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 is output only for pull queues.

This field has the same meaning as max_doublings in queue.yaml/xml.

int32 max_doublings = 6;

Returns
TypeDescription
int

The maxDoublings.

getMaxRetryDuration()

public Duration getMaxRetryDuration()

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Returns
TypeDescription
Duration

The maxRetryDuration.

getMaxRetryDurationBuilder()

public Duration.Builder getMaxRetryDurationBuilder()

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Returns
TypeDescription
Builder

getMaxRetryDurationOrBuilder()

public DurationOrBuilder getMaxRetryDurationOrBuilder()

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Returns
TypeDescription
DurationOrBuilder

getMinBackoff()

public Duration getMinBackoff()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Returns
TypeDescription
Duration

The minBackoff.

getMinBackoffBuilder()

public Duration.Builder getMinBackoffBuilder()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Returns
TypeDescription
Builder

getMinBackoffOrBuilder()

public DurationOrBuilder getMinBackoffOrBuilder()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Returns
TypeDescription
DurationOrBuilder

getNumAttemptsCase()

public RetryConfig.NumAttemptsCase getNumAttemptsCase()
Returns
TypeDescription
RetryConfig.NumAttemptsCase

getUnlimitedAttempts()

public boolean getUnlimitedAttempts()

If true, then the number of attempts is unlimited.

bool unlimited_attempts = 2;

Returns
TypeDescription
boolean

The unlimitedAttempts.

hasMaxAttempts()

public boolean hasMaxAttempts()

The maximum number of attempts for a 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 > 0.

int32 max_attempts = 1;

Returns
TypeDescription
boolean

Whether the maxAttempts field is set.

hasMaxBackoff()

public boolean hasMaxBackoff()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Returns
TypeDescription
boolean

Whether the maxBackoff field is set.

hasMaxRetryDuration()

public boolean hasMaxRetryDuration()

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Returns
TypeDescription
boolean

Whether the maxRetryDuration field is set.

hasMinBackoff()

public boolean hasMinBackoff()

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Returns
TypeDescription
boolean

Whether the minBackoff field is set.

hasUnlimitedAttempts()

public boolean hasUnlimitedAttempts()

If true, then the number of attempts is unlimited.

bool unlimited_attempts = 2;

Returns
TypeDescription
boolean

Whether the unlimitedAttempts field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeFrom(RetryConfig other)

public RetryConfig.Builder mergeFrom(RetryConfig other)
Parameter
NameDescription
otherRetryConfig
Returns
TypeDescription
RetryConfig.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public RetryConfig.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
RetryConfig.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public RetryConfig.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
RetryConfig.Builder
Overrides

mergeMaxBackoff(Duration value)

public RetryConfig.Builder mergeMaxBackoff(Duration value)

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Parameter
NameDescription
valueDuration
Returns
TypeDescription
RetryConfig.Builder

mergeMaxRetryDuration(Duration value)

public RetryConfig.Builder mergeMaxRetryDuration(Duration value)

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Parameter
NameDescription
valueDuration
Returns
TypeDescription
RetryConfig.Builder

mergeMinBackoff(Duration value)

public RetryConfig.Builder mergeMinBackoff(Duration value)

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Parameter
NameDescription
valueDuration
Returns
TypeDescription
RetryConfig.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final RetryConfig.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
RetryConfig.Builder
Overrides

setField(Descriptors.FieldDescriptor field, Object value)

public RetryConfig.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
RetryConfig.Builder
Overrides

setMaxAttempts(int value)

public RetryConfig.Builder setMaxAttempts(int value)

The maximum number of attempts for a 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 > 0.

int32 max_attempts = 1;

Parameter
NameDescription
valueint

The maxAttempts to set.

Returns
TypeDescription
RetryConfig.Builder

This builder for chaining.

setMaxBackoff(Duration value)

public RetryConfig.Builder setMaxBackoff(Duration value)

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Parameter
NameDescription
valueDuration
Returns
TypeDescription
RetryConfig.Builder

setMaxBackoff(Duration.Builder builderForValue)

public RetryConfig.Builder setMaxBackoff(Duration.Builder builderForValue)

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

max_backoff will be truncated to the nearest second.

This field has the same meaning as max_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration max_backoff = 5;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
RetryConfig.Builder

setMaxDoublings(int value)

public RetryConfig.Builder setMaxDoublings(int value)

The time between retries will double max_doublings times.

A task's retry interval starts at min_backoff, then doubles max_doublings times, then increases linearly, and finally retries at intervals of max_backoff up to max_attempts times.

For example, if min_backoff is 10s, 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 until the task has been attempted 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 is output only for pull queues.

This field has the same meaning as max_doublings in queue.yaml/xml.

int32 max_doublings = 6;

Parameter
NameDescription
valueint

The maxDoublings to set.

Returns
TypeDescription
RetryConfig.Builder

This builder for chaining.

setMaxRetryDuration(Duration value)

public RetryConfig.Builder setMaxRetryDuration(Duration value)

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Parameter
NameDescription
valueDuration
Returns
TypeDescription
RetryConfig.Builder

setMaxRetryDuration(Duration.Builder builderForValue)

public RetryConfig.Builder setMaxRetryDuration(Duration.Builder builderForValue)

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 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.

This field is output only for pull queues.

max_retry_duration will be truncated to the nearest second.

This field has the same meaning as task_age_limit in queue.yaml/xml.

.google.protobuf.Duration max_retry_duration = 3;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
RetryConfig.Builder

setMinBackoff(Duration value)

public RetryConfig.Builder setMinBackoff(Duration value)

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Parameter
NameDescription
valueDuration
Returns
TypeDescription
RetryConfig.Builder

setMinBackoff(Duration.Builder builderForValue)

public RetryConfig.Builder setMinBackoff(Duration.Builder builderForValue)

A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried.

If unspecified when the queue is created, Cloud Tasks will pick the default.

This field is output only for pull queues.

min_backoff will be truncated to the nearest second.

This field has the same meaning as min_backoff_seconds in queue.yaml/xml.

.google.protobuf.Duration min_backoff = 4;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
RetryConfig.Builder

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public RetryConfig.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
RetryConfig.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final RetryConfig.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
RetryConfig.Builder
Overrides

setUnlimitedAttempts(boolean value)

public RetryConfig.Builder setUnlimitedAttempts(boolean value)

If true, then the number of attempts is unlimited.

bool unlimited_attempts = 2;

Parameter
NameDescription
valueboolean

The unlimitedAttempts to set.

Returns
TypeDescription
RetryConfig.Builder

This builder for chaining.