Class RetryConfig.Builder (2.41.0)

publicstaticfinalclass RetryConfig.BuilderextendsGeneratedMessageV3.Builder<RetryConfig.Builder>implementsRetryConfigOrBuilder

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.

Protobuf type google.cloud.scheduler.v1.RetryConfig

Inherited Members

com.google.protobuf.GeneratedMessageV3.Builder.getUnknownFieldSetBuilder()
com.google.protobuf.GeneratedMessageV3.Builder.internalGetMapFieldReflection(int)
com.google.protobuf.GeneratedMessageV3.Builder.internalGetMutableMapFieldReflection(int)
com.google.protobuf.GeneratedMessageV3.Builder.mergeUnknownLengthDelimitedField(int,com.google.protobuf.ByteString)
com.google.protobuf.GeneratedMessageV3.Builder.mergeUnknownVarintField(int,int)
com.google.protobuf.GeneratedMessageV3.Builder.parseUnknownField(com.google.protobuf.CodedInputStream,com.google.protobuf.ExtensionRegistryLite,int)
com.google.protobuf.GeneratedMessageV3.Builder.setUnknownFieldSetBuilder(com.google.protobuf.UnknownFieldSet.Builder)

Static Methods

getDescriptor()

publicstaticfinalDescriptors.DescriptorgetDescriptor()
Returns
Type Description
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

publicRetryConfig.BuilderaddRepeatedField(Descriptors.FieldDescriptorfield,Objectvalue)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
RetryConfig.Builder
Overrides

build()

publicRetryConfigbuild()
Returns
Type Description
RetryConfig

buildPartial()

publicRetryConfigbuildPartial()
Returns
Type Description
RetryConfig

clear()

publicRetryConfig.Builderclear()
Returns
Type Description
RetryConfig.Builder
Overrides

clearField(Descriptors.FieldDescriptor field)

publicRetryConfig.BuilderclearField(Descriptors.FieldDescriptorfield)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
RetryConfig.Builder
Overrides

clearMaxBackoffDuration()

publicRetryConfig.BuilderclearMaxBackoffDuration()

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Returns
Type Description
RetryConfig.Builder

clearMaxDoublings()

publicRetryConfig.BuilderclearMaxDoublings()

The time between retries will double max_doublings times.

A job's retry interval starts at min_backoff_duration, then doubles max_doublings times, then increases linearly, and finally retries at intervals of max_backoff_duration up to retry_count times.

For example, if min_backoff_duration is 10s, 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 until the job has been attempted 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.

int32 max_doublings = 5;

Returns
Type Description
RetryConfig.Builder

This builder for chaining.

clearMaxRetryDuration()

publicRetryConfig.BuilderclearMaxRetryDuration()

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Returns
Type Description
RetryConfig.Builder

clearMinBackoffDuration()

publicRetryConfig.BuilderclearMinBackoffDuration()

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Returns
Type Description
RetryConfig.Builder

clearOneof(Descriptors.OneofDescriptor oneof)

publicRetryConfig.BuilderclearOneof(Descriptors.OneofDescriptoroneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
RetryConfig.Builder
Overrides

clearRetryCount()

publicRetryConfig.BuilderclearRetryCount()

The number of attempts that the system will make to run a job using the exponential backoff procedure described by 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.

int32 retry_count = 1;

Returns
Type Description
RetryConfig.Builder

This builder for chaining.

clone()

publicRetryConfig.Builderclone()
Returns
Type Description
RetryConfig.Builder
Overrides

getDefaultInstanceForType()

publicRetryConfiggetDefaultInstanceForType()
Returns
Type Description
RetryConfig

getDescriptorForType()

publicDescriptors.DescriptorgetDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getMaxBackoffDuration()

publicDurationgetMaxBackoffDuration()

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Returns
Type Description
Duration

The maxBackoffDuration.

getMaxBackoffDurationBuilder()

publicDuration.BuildergetMaxBackoffDurationBuilder()

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Returns
Type Description
Builder

getMaxBackoffDurationOrBuilder()

publicDurationOrBuildergetMaxBackoffDurationOrBuilder()

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Returns
Type Description
DurationOrBuilder

getMaxDoublings()

publicintgetMaxDoublings()

The time between retries will double max_doublings times.

A job's retry interval starts at min_backoff_duration, then doubles max_doublings times, then increases linearly, and finally retries at intervals of max_backoff_duration up to retry_count times.

For example, if min_backoff_duration is 10s, 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 until the job has been attempted 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.

int32 max_doublings = 5;

Returns
Type Description
int

The maxDoublings.

getMaxRetryDuration()

publicDurationgetMaxRetryDuration()

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Returns
Type Description
Duration

The maxRetryDuration.

getMaxRetryDurationBuilder()

publicDuration.BuildergetMaxRetryDurationBuilder()

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Returns
Type Description
Builder

getMaxRetryDurationOrBuilder()

publicDurationOrBuildergetMaxRetryDurationOrBuilder()

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Returns
Type Description
DurationOrBuilder

getMinBackoffDuration()

publicDurationgetMinBackoffDuration()

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Returns
Type Description
Duration

The minBackoffDuration.

getMinBackoffDurationBuilder()

publicDuration.BuildergetMinBackoffDurationBuilder()

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Returns
Type Description
Builder

getMinBackoffDurationOrBuilder()

publicDurationOrBuildergetMinBackoffDurationOrBuilder()

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Returns
Type Description
DurationOrBuilder

getRetryCount()

publicintgetRetryCount()

The number of attempts that the system will make to run a job using the exponential backoff procedure described by 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.

int32 retry_count = 1;

Returns
Type Description
int

The retryCount.

hasMaxBackoffDuration()

publicbooleanhasMaxBackoffDuration()

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Returns
Type Description
boolean

Whether the maxBackoffDuration field is set.

hasMaxRetryDuration()

publicbooleanhasMaxRetryDuration()

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Returns
Type Description
boolean

Whether the maxRetryDuration field is set.

hasMinBackoffDuration()

publicbooleanhasMinBackoffDuration()

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Returns
Type Description
boolean

Whether the minBackoffDuration field is set.

internalGetFieldAccessorTable()

protectedGeneratedMessageV3.FieldAccessorTableinternalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

publicfinalbooleanisInitialized()
Returns
Type Description
boolean
Overrides

mergeFrom(RetryConfig other)

publicRetryConfig.BuildermergeFrom(RetryConfigother)
Parameter
Name Description
other RetryConfig
Returns
Type Description
RetryConfig.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

publicRetryConfig.BuildermergeFrom(CodedInputStreaminput,ExtensionRegistryLiteextensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
RetryConfig.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

publicRetryConfig.BuildermergeFrom(Messageother)
Parameter
Name Description
other Message
Returns
Type Description
RetryConfig.Builder
Overrides

mergeMaxBackoffDuration(Duration value)

publicRetryConfig.BuildermergeMaxBackoffDuration(Durationvalue)

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Parameter
Name Description
value Duration
Returns
Type Description
RetryConfig.Builder

mergeMaxRetryDuration(Duration value)

publicRetryConfig.BuildermergeMaxRetryDuration(Durationvalue)

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Parameter
Name Description
value Duration
Returns
Type Description
RetryConfig.Builder

mergeMinBackoffDuration(Duration value)

publicRetryConfig.BuildermergeMinBackoffDuration(Durationvalue)

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Parameter
Name Description
value Duration
Returns
Type Description
RetryConfig.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

publicfinalRetryConfig.BuildermergeUnknownFields(UnknownFieldSetunknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
RetryConfig.Builder
Overrides

setField(Descriptors.FieldDescriptor field, Object value)

publicRetryConfig.BuildersetField(Descriptors.FieldDescriptorfield,Objectvalue)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
RetryConfig.Builder
Overrides

setMaxBackoffDuration(Duration value)

publicRetryConfig.BuildersetMaxBackoffDuration(Durationvalue)

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Parameter
Name Description
value Duration
Returns
Type Description
RetryConfig.Builder

setMaxBackoffDuration(Duration.Builder builderForValue)

publicRetryConfig.BuildersetMaxBackoffDuration(Duration.BuilderbuilderForValue)

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

The default value of this field is 1 hour.

.google.protobuf.Duration max_backoff_duration = 4;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
RetryConfig.Builder

setMaxDoublings(int value)

publicRetryConfig.BuildersetMaxDoublings(intvalue)

The time between retries will double max_doublings times.

A job's retry interval starts at min_backoff_duration, then doubles max_doublings times, then increases linearly, and finally retries at intervals of max_backoff_duration up to retry_count times.

For example, if min_backoff_duration is 10s, 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 until the job has been attempted 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.

int32 max_doublings = 5;

Parameter
Name Description
value int

The maxDoublings to set.

Returns
Type Description
RetryConfig.Builder

This builder for chaining.

setMaxRetryDuration(Duration value)

publicRetryConfig.BuildersetMaxRetryDuration(Durationvalue)

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Parameter
Name Description
value Duration
Returns
Type Description
RetryConfig.Builder

setMaxRetryDuration(Duration.Builder builderForValue)

publicRetryConfig.BuildersetMaxRetryDuration(Duration.BuilderbuilderForValue)

The time limit for retrying a failed job, measured from time when an execution was first attempted. If specified with 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.

.google.protobuf.Duration max_retry_duration = 2;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
RetryConfig.Builder

setMinBackoffDuration(Duration value)

publicRetryConfig.BuildersetMinBackoffDuration(Durationvalue)

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Parameter
Name Description
value Duration
Returns
Type Description
RetryConfig.Builder

setMinBackoffDuration(Duration.Builder builderForValue)

publicRetryConfig.BuildersetMinBackoffDuration(Duration.BuilderbuilderForValue)

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

The default value of this field is 5 seconds.

.google.protobuf.Duration min_backoff_duration = 3;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
RetryConfig.Builder

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

publicRetryConfig.BuildersetRepeatedField(Descriptors.FieldDescriptorfield,intindex,Objectvalue)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
RetryConfig.Builder
Overrides

setRetryCount(int value)

publicRetryConfig.BuildersetRetryCount(intvalue)

The number of attempts that the system will make to run a job using the exponential backoff procedure described by 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.

int32 retry_count = 1;

Parameter
Name Description
value int

The retryCount to set.

Returns
Type Description
RetryConfig.Builder

This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

publicfinalRetryConfig.BuildersetUnknownFields(UnknownFieldSetunknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
RetryConfig.Builder
Overrides

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年10月30日 UTC.