Class RateLimits.Builder (2.8.0)

public static final class RateLimits.Builder extends GeneratedMessageV3.Builder<RateLimits.Builder> implements RateLimitsOrBuilder

Rate limits. This message determines the maximum rate that tasks can be dised by a queue, regardless of whether the dis is a first task attempt or a retry. Note: The debugging command, RunTask, will run a task even if the queue has reached its RateLimits.

Protobuf type google.cloud.tasks.v2.RateLimits

Static Methods

getDescriptor()

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

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

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

build()

public RateLimits build()
Returns
TypeDescription
RateLimits

buildPartial()

public RateLimits buildPartial()
Returns
TypeDescription
RateLimits

clear()

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

clearField(Descriptors.FieldDescriptor field)

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

clearMaxBurstSize()

public RateLimits.Builder clearMaxBurstSize()

Output only. The max burst size. Max burst size limits how fast tasks in queue are processed when many tasks are in the queue and the rate is high. This field allows the queue to have a high rate so processing starts shortly after a task is enqueued, but still limits resource usage when many tasks are enqueued in a short period of time. The token bucket algorithm is used to control the rate of task dises. Each queue has a token bucket that holds tokens, up to the maximum specified by max_burst_size. Each time a task is dised, a token is removed from the bucket. Tasks will be dised until the queue's bucket runs out of tokens. The bucket will be continuously refilled with new tokens based on max_dises_per_second. Cloud Tasks will pick the value of max_burst_size based on the value of max_dises_per_second. For queues that were created or updated using queue.yaml/xml, max_burst_size is equal to bucket_size. Since max_burst_size is output only, if UpdateQueue is called on a queue created by queue.yaml/xml, max_burst_size will be reset based on the value of max_dises_per_second, regardless of whether max_dises_per_second is updated.

int32 max_burst_size = 2;

Returns
TypeDescription
RateLimits.Builder

This builder for chaining.

clearMaxConcurrentDises()

public RateLimits.Builder clearMaxConcurrentDises()

The maximum number of concurrent tasks that Cloud Tasks allows to be dised for this queue. After this threshold has been reached, Cloud Tasks stops dising tasks until the number of concurrent requests decreases. If unspecified when the queue is created, Cloud Tasks will pick the default. The maximum allowed value is 5,000. This field has the same meaning as max_concurrent_requests in queue.yaml/xml.

int32 max_concurrent_dises = 3;

Returns
TypeDescription
RateLimits.Builder

This builder for chaining.

clearMaxDisesPerSecond()

public RateLimits.Builder clearMaxDisesPerSecond()

The maximum rate at which tasks are dised from this queue. If unspecified when the queue is created, Cloud Tasks will pick the default.

double max_dises_per_second = 1;

Returns
TypeDescription
RateLimits.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

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

clone()

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

getDefaultInstanceForType()

public RateLimits getDefaultInstanceForType()
Returns
TypeDescription
RateLimits

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getMaxBurstSize()

public int getMaxBurstSize()

Output only. The max burst size. Max burst size limits how fast tasks in queue are processed when many tasks are in the queue and the rate is high. This field allows the queue to have a high rate so processing starts shortly after a task is enqueued, but still limits resource usage when many tasks are enqueued in a short period of time. The token bucket algorithm is used to control the rate of task dises. Each queue has a token bucket that holds tokens, up to the maximum specified by max_burst_size. Each time a task is dised, a token is removed from the bucket. Tasks will be dised until the queue's bucket runs out of tokens. The bucket will be continuously refilled with new tokens based on max_dises_per_second. Cloud Tasks will pick the value of max_burst_size based on the value of max_dises_per_second. For queues that were created or updated using queue.yaml/xml, max_burst_size is equal to bucket_size. Since max_burst_size is output only, if UpdateQueue is called on a queue created by queue.yaml/xml, max_burst_size will be reset based on the value of max_dises_per_second, regardless of whether max_dises_per_second is updated.

int32 max_burst_size = 2;

Returns
TypeDescription
int

The maxBurstSize.

getMaxConcurrentDises()

public int getMaxConcurrentDises()

The maximum number of concurrent tasks that Cloud Tasks allows to be dised for this queue. After this threshold has been reached, Cloud Tasks stops dising tasks until the number of concurrent requests decreases. If unspecified when the queue is created, Cloud Tasks will pick the default. The maximum allowed value is 5,000. This field has the same meaning as max_concurrent_requests in queue.yaml/xml.

int32 max_concurrent_dises = 3;

Returns
TypeDescription
int

The maxConcurrentDises.

getMaxDisesPerSecond()

public double getMaxDisesPerSecond()

The maximum rate at which tasks are dised from this queue. If unspecified when the queue is created, Cloud Tasks will pick the default.

double max_dises_per_second = 1;

Returns
TypeDescription
double

The maxDisesPerSecond.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeFrom(RateLimits other)

public RateLimits.Builder mergeFrom(RateLimits other)
Parameter
NameDescription
otherRateLimits
Returns
TypeDescription
RateLimits.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public RateLimits.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
RateLimits.Builder
OverridesExceptions
TypeDescription
IOException

mergeFrom(Message other)

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

mergeUnknownFields(UnknownFieldSet unknownFields)

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

setField(Descriptors.FieldDescriptor field, Object value)

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

setMaxBurstSize(int value)

public RateLimits.Builder setMaxBurstSize(int value)

Output only. The max burst size. Max burst size limits how fast tasks in queue are processed when many tasks are in the queue and the rate is high. This field allows the queue to have a high rate so processing starts shortly after a task is enqueued, but still limits resource usage when many tasks are enqueued in a short period of time. The token bucket algorithm is used to control the rate of task dises. Each queue has a token bucket that holds tokens, up to the maximum specified by max_burst_size. Each time a task is dised, a token is removed from the bucket. Tasks will be dised until the queue's bucket runs out of tokens. The bucket will be continuously refilled with new tokens based on max_dises_per_second. Cloud Tasks will pick the value of max_burst_size based on the value of max_dises_per_second. For queues that were created or updated using queue.yaml/xml, max_burst_size is equal to bucket_size. Since max_burst_size is output only, if UpdateQueue is called on a queue created by queue.yaml/xml, max_burst_size will be reset based on the value of max_dises_per_second, regardless of whether max_dises_per_second is updated.

int32 max_burst_size = 2;

Parameter
NameDescription
valueint

The maxBurstSize to set.

Returns
TypeDescription
RateLimits.Builder

This builder for chaining.

setMaxConcurrentDises(int value)

public RateLimits.Builder setMaxConcurrentDises(int value)

The maximum number of concurrent tasks that Cloud Tasks allows to be dised for this queue. After this threshold has been reached, Cloud Tasks stops dising tasks until the number of concurrent requests decreases. If unspecified when the queue is created, Cloud Tasks will pick the default. The maximum allowed value is 5,000. This field has the same meaning as max_concurrent_requests in queue.yaml/xml.

int32 max_concurrent_dises = 3;

Parameter
NameDescription
valueint

The maxConcurrentDises to set.

Returns
TypeDescription
RateLimits.Builder

This builder for chaining.

setMaxDisesPerSecond(double value)

public RateLimits.Builder setMaxDisesPerSecond(double value)

The maximum rate at which tasks are dised from this queue. If unspecified when the queue is created, Cloud Tasks will pick the default.

double max_dises_per_second = 1;

Parameter
NameDescription
valuedouble

The maxDisesPerSecond to set.

Returns
TypeDescription
RateLimits.Builder

This builder for chaining.

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

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

setUnknownFields(UnknownFieldSet unknownFields)

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