Reference documentation and code samples for the Google Cloud Tasks V2beta2 Client class RateLimits.
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 .
Generated from protobuf message google.cloud.tasks.v2beta2.RateLimits
Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ max_tasks_dispatched_per_second
float
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
.
↳ max_burst_size
int
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
.
↳ max_concurrent_tasks
int
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
.
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 .
float
setMaxTasksDispatchedPerSecond
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 .
var
float
$this
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
.
int
setMaxBurstSize
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
.
var
int
$this
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
.
int
setMaxConcurrentTasks
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
.
var
int
$this