Resource: Queue
A queue is a container of related tasks. Queues are configured to manage how those tasks are dispatched. Configurable properties include rate limits, retry options, queue types, and others.
JSON representation |
---|
{ "name": string, "appEngineRoutingOverride": { object ( |
Fields | |
---|---|
name |
Caller-specified and required in The queue name. The queue name must have the following format:
|
appEngineRoutingOverride |
Overrides for If set, |
rateLimits |
Rate limits for task dispatches.
The queue's actual dispatch rate is the result of:
|
retryConfig |
Settings that determine the retry behavior.
|
state |
Output only. The state of the queue.
|
purgeTime |
Output only. The last time this queue was purged. All tasks that were A queue can be purged using Purge time will be truncated to the nearest microsecond. Purge time will be unset if the queue has never been purged. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
stackdriverLoggingConfig |
Configuration options for writing logs to Stackdriver Logging. If this field is unset, then no logs are written. |
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
.
JSON representation |
---|
{ "maxDispatchesPerSecond": number, "maxBurstSize": integer, "maxConcurrentDispatches": integer } |
Fields | |
---|---|
maxDispatchesPerSecond |
The maximum rate at which tasks are dispatched from this queue. If unspecified when the queue is created, Cloud Tasks will pick the default.
This field has the same meaning as rate in queue.yaml/xml. |
maxBurstSize |
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 dispatches. Each queue has a token bucket that holds tokens, up to the maximum specified by Cloud Tasks will pick the value of For queues that were created or updated using |
maxConcurrentDispatches |
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 has the same meaning as max_concurrent_requests in queue.yaml/xml. |
RetryConfig
Retry config.
These settings determine when a failed task attempt is retried.
JSON representation |
---|
{ "maxAttempts": integer, "maxRetryDuration": string, "minBackoff": string, "maxBackoff": string, "maxDoublings": integer } |
Fields | |
---|---|
maxAttempts |
Number of attempts per task. Cloud Tasks will attempt the task If unspecified when the queue is created, Cloud Tasks will pick the default. -1 indicates unlimited attempts. This field has the same meaning as task_retry_limit in queue.yaml/xml. |
maxRetryDuration |
If positive, If zero, then the task age is unlimited. If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by This field has the same meaning as taskAgeLimit in queue.yaml/xml. |
minBackoff |
A task will be If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by This field has the same meaning as min_backoff_seconds in queue.yaml/xml. |
maxBackoff |
A task will be If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by This field has the same meaning as max_backoff_seconds in queue.yaml/xml. |
maxDoublings |
The time between retries will double A task's retry interval starts at For example, if If unspecified when the queue is created, Cloud Tasks will pick the default. This field has the same meaning as maxDoublings in queue.yaml/xml. |
State
State of the queue.
Enums | |
---|---|
STATE_UNSPECIFIED |
Unspecified state. |
RUNNING |
The queue is running. Tasks can be dispatched. If the queue was created using Cloud Tasks and the queue has had no activity (method calls or task dispatches) for 30 days, the queue may take a few minutes to re-activate. Some method calls may return |
PAUSED |
Tasks are paused by the user. If the queue is paused then Cloud Tasks will stop delivering tasks from it, but more tasks can still be added to it by the user. |
DISABLED |
The queue is disabled. A queue becomes When a queue is disabled, tasks can still be added to a queue but the tasks are not dispatched. To permanently delete this queue and all of its tasks, call |
StackdriverLoggingConfig
Configuration options for writing logs to Stackdriver Logging.
JSON representation |
---|
{ "samplingRatio": number } |
Fields | |
---|---|
samplingRatio |
Specifies the fraction of operations to write to Stackdriver Logging. This field may contain any value between 0.0 and 1.0, inclusive. 0.0 is the default and means that no operations are logged. |
Methods |
|
---|---|
|
Creates a queue. |
|
Deletes a queue. |
|
Gets a queue. |
|
Gets the access control policy for a Queue . |
|
Lists queues. |
|
Updates a queue. |
|
Pauses the queue. |
|
Purges a queue by deleting all of its tasks. |
|
Resume a queue. |
|
Sets the access control policy for a Queue . |
|
Returns permissions that a caller has on a Queue . |