public final class RateLimits extends GeneratedMessageV3 implements RateLimitsOrBuilder
Rate limits.
This message determines the maximum rate that tasks can be dispatched by a
queue, regardless of whether the dispatch 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.v2beta2.RateLimits
Static Fields
MAX_BURST_SIZE_FIELD_NUMBER
public static final int MAX_BURST_SIZE_FIELD_NUMBER
Field Value
MAX_CONCURRENT_TASKS_FIELD_NUMBER
public static final int MAX_CONCURRENT_TASKS_FIELD_NUMBER
Field Value
MAX_TASKS_DISPATCHED_PER_SECOND_FIELD_NUMBER
public static final int MAX_TASKS_DISPATCHED_PER_SECOND_FIELD_NUMBER
Field Value
Static Methods
getDefaultInstance()
public static RateLimits getDefaultInstance()
Returns
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns
newBuilder()
public static RateLimits.Builder newBuilder()
Returns
newBuilder(RateLimits prototype)
public static RateLimits.Builder newBuilder(RateLimits prototype)
Parameter
Returns
public static RateLimits parseDelimitedFrom(InputStream input)
Parameter
Returns
Exceptions
public static RateLimits parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(byte[] data)
public static RateLimits parseFrom(byte[] data)
Parameter
Name | Description |
data | byte[]
|
Returns
Exceptions
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static RateLimits parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteString data)
public static RateLimits parseFrom(ByteString data)
Parameter
Returns
Exceptions
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static RateLimits parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static RateLimits parseFrom(CodedInputStream input)
Parameter
Returns
Exceptions
public static RateLimits parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static RateLimits parseFrom(InputStream input)
Parameter
Returns
Exceptions
public static RateLimits parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteBuffer data)
public static RateLimits parseFrom(ByteBuffer data)
Parameter
Returns
Exceptions
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static RateLimits parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parser()
public static Parser<RateLimits> parser()
Returns
Methods
equals(Object obj)
public boolean equals(Object obj)
Parameter
Returns
Overrides
getDefaultInstanceForType()
public RateLimits getDefaultInstanceForType()
Returns
getMaxBurstSize()
public int getMaxBurstSize()
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 dispatches. Each
queue has a token bucket that holds tokens, up to the maximum
specified by max_burst_size
. Each time a task is dispatched, a
token is removed from the bucket. Tasks will be dispatched until
the queue's bucket runs out of tokens. The bucket will be
continuously refilled with new tokens based on
max_dispatches_per_second.
The default value of max_burst_size
is picked by Cloud Tasks
based on the value of
max_dispatches_per_second.
The maximum value of max_burst_size
is 500.
For App Engine queues that were created or updated using
queue.yaml/xml
, max_burst_size
is equal to
bucket_size.
If
UpdateQueue is called on a queue without
explicitly setting a value for max_burst_size
,
max_burst_size
value will get updated if
UpdateQueue is updating
max_dispatches_per_second.
int32 max_burst_size = 2;
Returns
Type | Description |
int | The maxBurstSize.
|
getMaxConcurrentTasks()
public int getMaxConcurrentTasks()
The maximum number of concurrent tasks that Cloud Tasks allows
to be dispatched for this queue. After this threshold has been
reached, Cloud Tasks stops dispatching 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 is output only for
pull queues and always -1, which indicates no limit. No other
queue types can have max_concurrent_tasks
set to -1.
This field has the same meaning as
max_concurrent_requests in
queue.yaml/xml.
int32 max_concurrent_tasks = 3;
Returns
Type | Description |
int | The maxConcurrentTasks.
|
getMaxTasksDispatchedPerSecond()
public double getMaxTasksDispatchedPerSecond()
The maximum rate at which tasks are dispatched from this queue.
If unspecified when the queue is created, Cloud Tasks will pick the
default.
- For App Engine queues, the maximum allowed value
is 500.
- This field is output only for pull queues. In addition to the
max_tasks_dispatched_per_second
limit, a maximum of 10 QPS of
LeaseTasks requests are allowed per pull queue.
This field has the same meaning as
rate in
queue.yaml/xml.
double max_tasks_dispatched_per_second = 1;
Returns
Type | Description |
double | The maxTasksDispatchedPerSecond.
|
getParserForType()
public Parser<RateLimits> getParserForType()
Returns
Overrides
getSerializedSize()
public int getSerializedSize()
Returns
Overrides
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Returns
Overrides
hashCode()
Returns
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
isInitialized()
public final boolean isInitialized()
Returns
Overrides
newBuilderForType()
public RateLimits.Builder newBuilderForType()
Returns
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected RateLimits.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Returns
Overrides
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Returns
Overrides
toBuilder()
public RateLimits.Builder toBuilder()
Returns
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Parameter
Overrides
Exceptions