Queue(mapping=None, *, ignore_unknown_fields=False, **kwargs)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, target types, and others.
Attributes
| Name | Description |
name |
str
Caller-specified and required in CreateQueue, after which it becomes output only. The queue name. The queue name must have the following format: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID
- PROJECT_ID can contain letters ([A-Za-z]), numbers
([0-9]), hyphens (-), colons (:), or periods (.). For
more information, see `Identifying
projects |
app_engine_http_target |
google.cloud.tasks_v2beta2.types.AppEngineHttpTarget
App Engine HTTP target. An App Engine queue is a queue that has an AppEngineHttpTarget. |
pull_target |
google.cloud.tasks_v2beta2.types.PullTarget
Pull target. A pull queue is a queue that has a PullTarget. |
rate_limits |
google.cloud.tasks_v2beta2.types.RateLimits
Rate limits for task dispatches. rate_limits and retry_config are related because they both control task attempts however they control how tasks are attempted in different ways: - rate_limits controls the total rate of dispatches from a queue (i.e. all traffic dispatched from the queue, regardless of whether the dispatch is from a first attempt or a retry). - retry_config controls what happens to particular a task after its first attempt fails. That is, retry_config controls task retries (the second attempt, third attempt, etc). |
retry_config |
google.cloud.tasks_v2beta2.types.RetryConfig
Settings that determine the retry behavior. - For tasks created using Cloud Tasks: the queue-level retry settings apply to all tasks in the queue that were created using Cloud Tasks. Retry settings cannot be set on individual tasks. - For tasks created using the App Engine SDK: the queue-level retry settings apply to all tasks in the queue which do not have retry settings explicitly set on the task and were created by the App Engine SDK. See `App Engine documentation |
state |
google.cloud.tasks_v2beta2.types.Queue.State
Output only. The state of the queue. state can only be changed by calling
PauseQueue,
ResumeQueue,
or uploading
queue.yaml/xml __.
UpdateQueue
cannot be used to change state.
|
purge_time |
google.protobuf.timestamp_pb2.Timestamp
Output only. The last time this queue was purged. All tasks that were created before this time were purged. A queue can be purged using PurgeQueue, the `App Engine Task Queue SDK, or the Cloud Console |
task_ttl |
google.protobuf.duration_pb2.Duration
The maximum amount of time that a task will be retained in this queue. Queues created by Cloud Tasks have a default task_ttl of
31 days. After a task has lived for task_ttl, the task
will be deleted regardless of whether it was dispatched or
not.
The task_ttl for queues created via queue.yaml/xml is
equal to the maximum duration because there is a `storage
quota |
tombstone_ttl |
google.protobuf.duration_pb2.Duration
The task tombstone time to live (TTL). After a task is deleted or completed, the task's tombstone is retained for the length of time specified by tombstone_ttl. The tombstone is used by task
de-duplication; another task with the same name can't be
created until the tombstone has expired. For more
information about task de-duplication, see the documentation
for
CreateTaskRequest.
Queues created by Cloud Tasks have a default
tombstone_ttl of 1 hour.
|
stats |
google.cloud.tasks_v2beta2.types.QueueStats
Output only. The realtime, informational statistics for a queue. In order to receive the statistics the caller should include this field in the FieldMask. |
Classes
State
State(value)State of the queue.