docs: update generated docs (#981)
diff --git a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html
index 11d0f41..f73df1b 100644
--- a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html
+++ b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html
@@ -92,7 +92,7 @@
<code><a href="#getIamPolicy">getIamPolicy(resource, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the access control policy for a Queue.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists queues.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -144,6 +144,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -234,15 +257,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -277,6 +291,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -293,19 +331,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -322,30 +347,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -358,37 +389,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -416,63 +445,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}
x__xgafv: string, V1 error format.
@@ -486,6 +491,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -576,15 +604,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -619,6 +638,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -635,19 +678,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -664,30 +694,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -700,37 +736,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -758,63 +792,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}</pre>
</div>
@@ -875,6 +885,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -965,15 +998,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -1008,6 +1032,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -1024,19 +1072,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -1053,30 +1088,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -1089,37 +1130,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -1147,63 +1186,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}</pre>
</div>
@@ -1367,8 +1382,6 @@
#
"A String",
],
- "role": "A String", # Role that is assigned to `members`.
- # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
"condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
#
# If the condition evaluates to `true`, then this binding applies to the
@@ -1411,16 +1424,18 @@
# The exact variables and functions that may be referenced within an expression
# are determined by the service that evaluates it. See the service
# documentation for additional information.
- "description": "A String", # Optional. Description of the expression. This is a longer text which
- # describes the expression, e.g. when hovered over it in a UI.
+ "location": "A String", # Optional. String indicating the location of the expression for error
+ # reporting, e.g. a file name and a position in the file.
"expression": "A String", # Textual representation of an expression in Common Expression Language
# syntax.
+ "description": "A String", # Optional. Description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
"title": "A String", # Optional. Title for the expression, i.e. a short string describing
# its purpose. This can be used e.g. in UIs which allow to enter the
# expression.
- "location": "A String", # Optional. String indicating the location of the expression for error
- # reporting, e.g. a file name and a position in the file.
},
+ "role": "A String", # Role that is assigned to `members`.
+ # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
},
],
"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
@@ -1463,7 +1478,7 @@
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists queues.
Queues are returned in lexicographical order.
@@ -1471,21 +1486,6 @@
Args:
parent: string, Required. The location name.
For example: `projects/PROJECT_ID/locations/LOCATION_ID` (required)
- pageToken: string, A token identifying the page of results to return.
-
-To request the first page results, page_token must be empty. To
-request the next page of results, page_token must be the value of
-next_page_token returned
-from the previous call to ListQueues
-method. It is an error to switch the value of the
-filter while iterating through pages.
- pageSize: integer, Requested page size.
-
-The maximum page size is 9800. If unspecified, the page size will
-be the maximum. Fewer queues than requested might be returned,
-even if more queues exist; use the
-next_page_token in the
-response to determine if more queues exist.
filter: string, `filter` can be used to specify a subset of queues. Any Queue
field can be used as a filter and several operators as supported.
For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
@@ -1497,6 +1497,21 @@
Note that using filters might cause fewer queues than the
requested page_size to be returned.
+ pageSize: integer, Requested page size.
+
+The maximum page size is 9800. If unspecified, the page size will
+be the maximum. Fewer queues than requested might be returned,
+even if more queues exist; use the
+next_page_token in the
+response to determine if more queues exist.
+ pageToken: string, A token identifying the page of results to return.
+
+To request the first page results, page_token must be empty. To
+request the next page of results, page_token must be the value of
+next_page_token returned
+from the previous call to ListQueues
+method. It is an error to switch the value of the
+filter while iterating through pages.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -1519,6 +1534,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -1609,15 +1647,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -1652,6 +1681,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -1668,19 +1721,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -1697,30 +1737,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -1733,37 +1779,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -1791,63 +1835,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
},
],
}</pre>
@@ -1911,6 +1931,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -2001,15 +2044,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -2044,6 +2078,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -2060,19 +2118,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -2089,30 +2134,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -2125,37 +2176,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -2183,63 +2232,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}
updateMask: string, A mask used to specify which fields of the queue are being updated.
@@ -2256,6 +2281,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -2346,15 +2394,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -2389,6 +2428,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -2405,19 +2468,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -2434,30 +2484,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -2470,37 +2526,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -2528,63 +2582,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}</pre>
</div>
@@ -2618,6 +2648,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -2708,15 +2761,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -2751,6 +2795,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -2767,19 +2835,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -2796,30 +2851,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -2832,37 +2893,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -2890,63 +2949,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}</pre>
</div>
@@ -2979,6 +3014,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -3069,15 +3127,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -3112,6 +3161,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -3128,19 +3201,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -3157,30 +3217,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -3193,37 +3259,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -3251,63 +3315,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}</pre>
</div>
@@ -3347,6 +3387,29 @@
{ # 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.
+ "type": "A String", # Immutable. The type of a queue (push or pull).
+ #
+ # `Queue.type` is an immutable property of the queue that is set at the queue
+ # creation time. When left unspecified, the default value of `PUSH` is
+ # selected.
+ "purgeTime": "A String", # 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](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ #
+ # Purge time will be truncated to the nearest microsecond. Purge
+ # time will be unset if the queue has never been purged.
+ "state": "A String", # Output only. The state of the queue.
+ #
+ # `state` can only be changed by called
+ # PauseQueue,
+ # ResumeQueue, or uploading
+ # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+ # UpdateQueue cannot be used to change `state`.
"rateLimits": { # Rate limits. # Rate limits for task dispatches.
#
# rate_limits and retry_config are
@@ -3437,15 +3500,6 @@
# [rate in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
},
- "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
- # field is unset, then no logs are written.
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- "samplingRatio": 3.14, # Specifies the fraction of operations to write to
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
- # 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.
- },
"appEngineHttpQueue": { # App Engine HTTP queue. # AppEngineHttpQueue settings apply only to
# App Engine tasks in this queue.
# Http tasks are not affected by this proto.
@@ -3480,6 +3534,30 @@
# routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
# and [App Engine Flex request
# routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "host": "A String", # Output only. The host that the task is sent to.
+ #
+ # The host is constructed from the domain name of the app associated with
+ # the queue's project ID (for example <app-id>.appspot.com), and the
+ # service, version,
+ # and instance. Tasks which were created using
+ # the App Engine SDK might have a custom domain name.
+ #
+ # For more information, see
+ # [How Requests are
+ # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"service": "A String", # App service.
#
# By default, the task is sent to the service which is the default
@@ -3496,19 +3574,6 @@
# service,
# version, and
# instance are the empty string.
- "instance": "A String", # App instance.
- #
- # By default, the task is sent to an instance which is available when
- # the task is attempted.
- #
- # Requests can only be sent to a specific instance if
- # [manual scaling is used in App Engine
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
- # App Engine Flex does not support instances. For more information, see
- # [App Engine Standard request
- # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
- # and [App Engine Flex request
- # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
"version": "A String", # App version.
#
# By default, the task is sent to the version which is the default
@@ -3525,30 +3590,36 @@
# service,
# version, and
# instance are the empty string.
- "host": "A String", # Output only. The host that the task is sent to.
- #
- # The host is constructed from the domain name of the app associated with
- # the queue's project ID (for example <app-id>.appspot.com), and the
- # service, version,
- # and instance. Tasks which were created using
- # the App Engine SDK might have a custom domain name.
- #
- # For more information, see
- # [How Requests are
- # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
},
},
- "purgeTime": "A String", # Output only. The last time this queue was purged.
+ "name": "A String", # Caller-specified and required in CreateQueue,
+ # after which it becomes output only.
#
- # All tasks that were created before this time
- # were purged.
+ # The queue name.
#
- # A queue can be purged using PurgeQueue, the
- # [App Engine Task Queue SDK, or the Cloud
- # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
+ # The queue name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
#
- # Purge time will be truncated to the nearest microsecond. Purge
- # time will be unset if the queue has never been purged.
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the queue's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ "stackdriverLoggingConfig": { # Configuration options for writing logs to # Configuration options for writing logs to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+ # field is unset, then no logs are written.
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ "samplingRatio": 3.14, # Specifies the fraction of operations to write to
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+ # 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.
+ },
"retryConfig": { # Retry config. # Settings that determine the retry behavior.
#
# * For tasks created using Cloud Tasks: the queue-level retry settings
@@ -3561,37 +3632,35 @@
# documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
#
# These settings determine when a failed task attempt is retried.
- "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
- # retrying a failed task, measured from when the task was first
- # attempted. Once `max_retry_duration` time has passed *and* the
- # task has been attempted max_attempts
- # times, no further attempts will be made and the task will be
- # deleted.
- #
- # If zero, then the task age is unlimited.
+ "maxBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_retry_duration` will be truncated to the nearest second.
+ # `max_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_age_limit in
+ # [max_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxAttempts": 42, # Number of attempts per task.
- #
- # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
- # first attempt fails, then there will be `max_attempts - 1` retries). Must
- # be >= -1.
+ "minBackoff": "A String", # A task will be scheduled for retry between
+ # min_backoff and
+ # max_backoff duration after it fails,
+ # if the queue's RetryConfig specifies that the task should be
+ # retried.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- # -1 indicates unlimited attempts.
+ #
+ # `min_backoff` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [task_retry_limit in
+ # [min_backoff_seconds in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
"maxDoublings": 42, # The time between retries will double `max_doublings` times.
#
@@ -3619,63 +3688,39 @@
# This field has the same meaning as
# [max_doublings in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "minBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxAttempts": 42, # Number of attempts per task.
+ #
+ # Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+ # first attempt fails, then there will be `max_attempts - 1` retries). Must
+ # be >= -1.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
- #
- # `min_backoff` will be truncated to the nearest second.
+ # -1 indicates unlimited attempts.
#
# This field has the same meaning as
- # [min_backoff_seconds in
+ # [task_retry_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
- "maxBackoff": "A String", # A task will be scheduled for retry between
- # min_backoff and
- # max_backoff duration after it fails,
- # if the queue's RetryConfig specifies that the task should be
- # retried.
+ "maxRetryDuration": "A String", # If positive, `max_retry_duration` specifies the time limit for
+ # retrying a failed task, measured from when the task was first
+ # attempted. Once `max_retry_duration` time has passed *and* the
+ # task has been attempted max_attempts
+ # times, no further attempts will be made and the task will be
+ # deleted.
+ #
+ # If zero, then the task age is unlimited.
#
# If unspecified when the queue is created, Cloud Tasks will pick the
# default.
#
#
- # `max_backoff` will be truncated to the nearest second.
+ # `max_retry_duration` will be truncated to the nearest second.
#
# This field has the same meaning as
- # [max_backoff_seconds in
+ # [task_age_limit in
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
},
- "state": "A String", # Output only. The state of the queue.
- #
- # `state` can only be changed by called
- # PauseQueue,
- # ResumeQueue, or uploading
- # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
- # UpdateQueue cannot be used to change `state`.
- "name": "A String", # 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the queue's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
}</pre>
</div>
@@ -3819,8 +3864,6 @@
#
"A String",
],
- "role": "A String", # Role that is assigned to `members`.
- # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
"condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
#
# If the condition evaluates to `true`, then this binding applies to the
@@ -3863,16 +3906,18 @@
# The exact variables and functions that may be referenced within an expression
# are determined by the service that evaluates it. See the service
# documentation for additional information.
- "description": "A String", # Optional. Description of the expression. This is a longer text which
- # describes the expression, e.g. when hovered over it in a UI.
+ "location": "A String", # Optional. String indicating the location of the expression for error
+ # reporting, e.g. a file name and a position in the file.
"expression": "A String", # Textual representation of an expression in Common Expression Language
# syntax.
+ "description": "A String", # Optional. Description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
"title": "A String", # Optional. Title for the expression, i.e. a short string describing
# its purpose. This can be used e.g. in UIs which allow to enter the
# expression.
- "location": "A String", # Optional. String indicating the location of the expression for error
- # reporting, e.g. a file name and a position in the file.
},
+ "role": "A String", # Role that is assigned to `members`.
+ # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
},
],
"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
@@ -4038,8 +4083,6 @@
#
"A String",
],
- "role": "A String", # Role that is assigned to `members`.
- # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
"condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
#
# If the condition evaluates to `true`, then this binding applies to the
@@ -4082,16 +4125,18 @@
# The exact variables and functions that may be referenced within an expression
# are determined by the service that evaluates it. See the service
# documentation for additional information.
- "description": "A String", # Optional. Description of the expression. This is a longer text which
- # describes the expression, e.g. when hovered over it in a UI.
+ "location": "A String", # Optional. String indicating the location of the expression for error
+ # reporting, e.g. a file name and a position in the file.
"expression": "A String", # Textual representation of an expression in Common Expression Language
# syntax.
+ "description": "A String", # Optional. Description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
"title": "A String", # Optional. Title for the expression, i.e. a short string describing
# its purpose. This can be used e.g. in UIs which allow to enter the
# expression.
- "location": "A String", # Optional. String indicating the location of the expression for error
- # reporting, e.g. a file name and a position in the file.
},
+ "role": "A String", # Role that is assigned to `members`.
+ # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
},
],
"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help