docs: docs update (#911)
Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/google-api-python-client/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
Fixes #<issue_number_goes_here> 🦕
diff --git a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html
index 512dfb4..c41a79f 100644
--- a/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html
+++ b/docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html
@@ -84,7 +84,7 @@
<code><a href="#get">get(name, responseView=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a task.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, responseView=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, responseView=None, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists the tasks in a queue.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -110,19 +110,7 @@
The object takes the form of:
{ # Request message for CreateTask.
- "responseView": "A String", # The response_view specifies which subset of the Task will be
- # returned.
- #
- # By default response_view is BASIC; not all
- # information is retrieved by default because some data, such as
- # payloads, might be desirable to return only when needed because
- # of its large size or because of the sensitivity of data that it
- # contains.
- #
- # Authorization for FULL requires
- # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
- # permission on the Task resource.
- "task": { # A unit of scheduled work. # Required. The task to add.
+ "task": { # A unit of scheduled work. # Required. The task to add.
#
# Task names have the following format:
# `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
@@ -137,13 +125,13 @@
# Task De-duplication:
#
# Explicitly specifying a task ID enables task de-duplication. If
- # a task's ID is identical to that of an existing task or a task
+ # a task's ID is identical to that of an existing task or a task
# that was deleted or executed recently then the call will fail
# with ALREADY_EXISTS.
- # If the task's queue was created using Cloud Tasks, then another task with
- # the same name can't be created for ~1hour after the original task was
- # deleted or executed. If the task's queue was created using queue.yaml or
- # queue.xml, then another task with the same name can't be created
+ # If the task's queue was created using Cloud Tasks, then another task with
+ # the same name can't be created for ~1hour after the original task was
+ # deleted or executed. If the task's queue was created using queue.yaml or
+ # queue.xml, then another task with the same name can't be created
# for ~9days after the original task was deleted or executed.
#
# Because there is an extra lookup cost to identify duplicate task
@@ -155,123 +143,110 @@
# task commands. The infrastructure relies on an approximately
# uniform distribution of task ids to store and serve tasks
# efficiently.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+ # respond by this deadline then the request is cancelled and the attempt
+ # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+ # task according to the RetryConfig.
#
- # An HTTP task is a task that has HttpRequest set.
+ # Note that when the request is cancelled, Cloud Tasks will stop listing for
+ # the response, but whether the worker stops processing depends on the
+ # worker. For example, if the worker is stuck, it may not react to cancelled
+ # requests.
#
- # The task will be pushed to the worker as an HTTP request. If the worker
- # or the redirected worker acknowledges the task by returning a successful HTTP
- # response code ([`200` - `299`]), the task will be removed from the queue. If
- # any other HTTP response code is returned or no response is received, the
- # task will be retried according to the following:
+ # The default and maximum values depend on the type of request:
#
- # * User-specified throttling: retry configuration,
- # rate limits, and the queue's state.
+ # * For HTTP tasks, the default is 10 minutes. The deadline
+ # must be in the interval [15 seconds, 30 minutes].
#
- # * System throttling: To prevent the worker from overloading, Cloud Tasks may
- # temporarily reduce the queue's effective rate. User-specified settings
- # will not be changed.
+ # * For App Engine tasks, 0 indicates that the
+ # request has the default deadline. The default deadline depends on the
+ # [scaling
+ # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
+ # of the service: 10 minutes for standard apps with automatic scaling, 24
+ # hours for standard apps with manual and basic scaling, and 60 minutes for
+ # flex apps. If the request deadline is set, it must be in the interval [15
+ # seconds, 24 hours 15 seconds]. Regardless of the task's
+ # `dispatch_deadline`, the app handler will not run for longer than than
+ # the service's timeout. We recommend setting the `dispatch_deadline` to
+ # at most a few seconds more than the app handler's timeout. For more
+ # information see
+ # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
#
- # System throttling happens because:
+ # `dispatch_deadline` will be truncated to the nearest millisecond. The
+ # deadline is an approximate deadline.
+ "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
- # * Cloud Tasks backs off on all errors. Normally the backoff specified in
- # rate limits will be used. But if the worker returns
- # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
- # errors is high, Cloud Tasks will use a higher backoff rate. The retry
- # specified in the `Retry-After` HTTP response header is considered.
- #
- # * To prevent traffic spikes and to smooth sudden increases in traffic,
- # dispatches ramp up slowly when the queue is newly created or idle and
- # if large numbers of tasks suddenly become available to dispatch (due to
- # spikes in create task rates, the queue being unpaused, or many tasks
- # that are scheduled at the same time).
- "body": "A String", # HTTP request body.
+ # Only dispatch_time will be set.
+ # The other Attempt information is not retained by Cloud Tasks.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
#
- # A request body is allowed only if the
- # HTTP method is POST, PUT, or PATCH. It is an
- # error to set body on a task with an incompatible HttpMethod.
- "headers": { # HTTP request headers.
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
#
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
#
- # These headers represent a subset of the headers that will accompany the
- # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
#
- # A partial list of headers that will be ignored or replaced is:
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
#
- # * Host: This will be computed by Cloud Tasks and derived from
- # HttpRequest.url.
- # * Content-Length: This will be computed by Cloud Tasks.
- # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
- # * X-Google-*: Google use only.
- # * X-AppEngine-*: Google use only.
- #
- # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
- # `Content-Type` to a media type when the
- # task is created.
- # For example, `Content-Type` can be set to `"application/octet-stream"` or
- # `"application/json"`.
- #
- # Headers which can have multiple values (according to RFC2616) can be
- # specified using comma-separated values.
- #
- # The size of the headers must be less than 80KB.
- "a_key": "A String",
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
- "url": "A String", # Required. The full url path that the request will be sent to.
- #
- # This string must begin with either "http://" or "https://". Some examples
- # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
- # encode some characters for safety and compatibility. The maximum allowed
- # URL length is 2083 characters after encoding.
- #
- # The `Location` header response from a redirect response [`300` - `399`]
- # may be followed. The redirect is not counted as a separate attempt.
- "oidcToken": { # Contains information needed for generating an # If specified, an
- # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
- # token will be generated and attached as an `Authorization` header in the
- # HTTP request.
- #
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- # [OpenID Connect
- # token](https://developers.google.com/identity/protocols/OpenIDConnect).
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OIDC token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "oauthToken": { # Contains information needed for generating an # If specified, an
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
- # will be generated and attached as an `Authorization` header in the HTTP
- # request.
- #
- # This type of authorization should generally only be used when calling
- # Google APIs hosted on *.googleapis.com.
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
- # This type of authorization should generally only be used when calling Google
- # APIs hosted on *.googleapis.com.
- "scope": "A String", # OAuth scope to be used for generating OAuth access token.
- # If not specified, "https://www.googleapis.com/auth/cloud-platform"
- # will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OAuth token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
},
- "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ #
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
+ #
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ #
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ },
+ },
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
+ "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
#
# An App Engine task is a task that has AppEngineHttpRequest set.
#
@@ -323,112 +298,18 @@
# required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
# Task dispatches also do not follow redirects.
#
- # The task attempt has succeeded if the app's request handler returns an HTTP
+ # The task attempt has succeeded if the app's request handler returns an HTTP
# response code in the range [`200` - `299`]. The task attempt has failed if
- # the app's handler returns a non-2xx response code or Cloud Tasks does
+ # the app's handler returns a non-2xx response code or Cloud Tasks does
# not receive response before the deadline. Failed
# tasks will be retried according to the
# retry configuration. `503` (Service Unavailable) is
# considered an App Engine system error instead of an application error and
- # will cause Cloud Tasks' traffic congestion control to temporarily throttle
- # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+ # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+ # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
# Requests) response from an app handler does not cause traffic congestion
# control to throttle the queue.
- "body": "A String", # HTTP request body.
- #
- # A request body is allowed only if the HTTP method is POST or PUT. It is
- # an error to set a body on a task with an incompatible HttpMethod.
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- #
- # The app's request handler for the task's target URL must be able to handle
- # HTTP requests with this http_method, otherwise the task attempt fails with
- # error code 405 (Method Not Allowed). See [Writing a push task request
- # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
- # and the App Engine documentation for your runtime on [How Requests are
- # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # If set,
- # app_engine_routing_override
- # is used for all tasks in the queue, no matter what the setting is for the
- # task-level app_engine_routing.
- #
- # Defines routing characteristics specific to App Engine - service, version,
- # and instance.
- #
- # For more information about services, versions, and instances see
- # [An Overview of App
- # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
- # [Microservices Architecture on Google App
- # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
- # [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).
- "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).
- "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).
- "version": "A String", # App version.
- #
- # By default, the task is sent to the version which is the default
- # version when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- "service": "A String", # App service.
- #
- # By default, the task is sent to the service which is the default
- # service when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- },
- "relativeUri": "A String", # The relative URI.
- #
- # The relative URI must begin with "/" and must be a valid HTTP relative URI.
- # It can contain a path and query string arguments.
- # If the relative URI is empty, then the root path "/" will be used.
- # No spaces are allowed, and the maximum length allowed is 2083 characters.
- "headers": { # HTTP request headers.
+ "headers": { # HTTP request headers.
#
# This map contains the header field names and values.
# Headers can be set when the
@@ -438,19 +319,19 @@
# Cloud Tasks sets some headers to default values:
#
# * `User-Agent`: By default, this header is
- # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
# This header can be modified, but Cloud Tasks will append
- # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
# modified `User-Agent`.
#
# If the task has a body, Cloud
# Tasks sets the following headers:
#
# * `Content-Type`: By default, the `Content-Type` header is set to
- # `"application/octet-stream"`. The default can be overridden by explicitly
+ # `"application/octet-stream"`. The default can be overridden by explicitly
# setting `Content-Type` to a particular media type when the
# task is created.
- # For example, `Content-Type` can be set to `"application/json"`.
+ # For example, `Content-Type` can be set to `"application/json"`.
# * `Content-Length`: This is computed by Cloud Tasks. This value is
# output only. It cannot be changed.
#
@@ -470,77 +351,230 @@
# Although there is no specific limit for the maximum number of headers or
# the size, there is a limit on the maximum size of the Task. For more
# information, see the CreateTask documentation.
- "a_key": "A String",
+ "a_key": "A String",
},
+ "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+ #
+ # If set,
+ # app_engine_routing_override
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level app_engine_routing.
+ #
+ # Defines routing characteristics specific to App Engine - service, version,
+ # and instance.
+ #
+ # For more information about services, versions, and instances see
+ # [An Overview of App
+ # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+ # [Microservices Architecture on Google App
+ # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+ # [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
+ # version when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ "service": "A String", # App service.
+ #
+ # By default, the task is sent to the service which is the default
+ # service when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ #
+ # The app's request handler for the task's target URL must be able to handle
+ # HTTP requests with this http_method, otherwise the task attempt fails with
+ # error code 405 (Method Not Allowed). See [Writing a push task request
+ # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+ # and the App Engine documentation for your runtime on [How Requests are
+ # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
+ "body": "A String", # HTTP request body.
+ #
+ # A request body is allowed only if the HTTP method is POST or PUT. It is
+ # an error to set a body on a task with an incompatible HttpMethod.
+ "relativeUri": "A String", # The relative URI.
+ #
+ # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+ # It can contain a path and query string arguments.
+ # If the relative URI is empty, then the root path "/" will be used.
+ # No spaces are allowed, and the maximum length allowed is 2083 characters.
},
- "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "createTime": "A String", # Output only. The time that the task was created.
#
- # Only dispatch_time will be set.
- # The other Attempt information is not retained by Cloud Tasks.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ # `create_time` will be truncated to the nearest second.
+ "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+ #
+ # For App Engine queues, this is when the task will be attempted or retried.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ #
+ # An HTTP task is a task that has HttpRequest set.
+ #
+ # The task will be pushed to the worker as an HTTP request. If the worker
+ # or the redirected worker acknowledges the task by returning a successful HTTP
+ # response code ([`200` - `299`]), the task will be removed from the queue. If
+ # any other HTTP response code is returned or no response is received, the
+ # task will be retried according to the following:
+ #
+ # * User-specified throttling: retry configuration,
+ # rate limits, and the queue's state.
+ #
+ # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+ # temporarily reduce the queue's effective rate. User-specified settings
+ # will not be changed.
+ #
+ # System throttling happens because:
+ #
+ # * Cloud Tasks backs off on all errors. Normally the backoff specified in
+ # rate limits will be used. But if the worker returns
+ # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+ # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+ # specified in the `Retry-After` HTTP response header is considered.
+ #
+ # * To prevent traffic spikes and to smooth sudden increases in traffic,
+ # dispatches ramp up slowly when the queue is newly created or idle and
+ # if large numbers of tasks suddenly become available to dispatch (due to
+ # spikes in create task rates, the queue being unpaused, or many tasks
+ # that are scheduled at the same time).
+ "url": "A String", # Required. The full url path that the request will be sent to.
#
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ # This string must begin with either "http://" or "https://". Some examples
+ # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+ # encode some characters for safety and compatibility. The maximum allowed
+ # URL length is 2083 characters after encoding.
#
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
+ # The `Location` header response from a redirect response [`300` - `399`]
+ # may be followed. The redirect is not counted as a separate attempt.
+ "oidcToken": { # Contains information needed for generating an # If specified, an
+ # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+ # token will be generated and attached as an `Authorization` header in the
+ # HTTP request.
#
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ # [OpenID Connect
+ # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OIDC token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "body": "A String", # HTTP request body.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # A request body is allowed only if the
+ # HTTP method is POST, PUT, or PATCH. It is an
+ # error to set body on a task with an incompatible HttpMethod.
+ "oauthToken": { # Contains information needed for generating an # If specified, an
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+ # will be generated and attached as an `Authorization` header in the HTTP
+ # request.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
- },
- "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
- #
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization should generally only be used when calling
+ # Google APIs hosted on *.googleapis.com.
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+ # This type of authorization should generally only be used when calling Google
+ # APIs hosted on *.googleapis.com.
+ "scope": "A String", # OAuth scope to be used for generating OAuth access token.
+ # If not specified, "https://www.googleapis.com/auth/cloud-platform"
+ # will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OAuth token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "headers": { # HTTP request headers.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
+ # These headers represent a subset of the headers that will accompany the
+ # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ #
+ # A partial list of headers that will be ignored or replaced is:
+ #
+ # * Host: This will be computed by Cloud Tasks and derived from
+ # HttpRequest.url.
+ # * Content-Length: This will be computed by Cloud Tasks.
+ # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+ # * X-Google-*: Google use only.
+ # * X-AppEngine-*: Google use only.
+ #
+ # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+ # `Content-Type` to a media type when the
+ # task is created.
+ # For example, `Content-Type` can be set to `"application/octet-stream"` or
+ # `"application/json"`.
+ #
+ # Headers which can have multiple values (according to RFC2616) can be
+ # specified using comma-separated values.
+ #
+ # The size of the headers must be less than 80KB.
+ "a_key": "A String",
+ },
},
- "name": "A String", # Optionally caller-specified in CreateTask.
+ "name": "A String", # Optionally caller-specified in CreateTask.
#
# The task name.
#
@@ -552,7 +586,7 @@
# 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 task's location.
+ # * `LOCATION_ID` is the canonical ID for the task's location.
# The list of available locations can be obtained by calling
# ListLocations.
# For more information, see https://cloud.google.com/about/locations/.
@@ -560,53 +594,19 @@
# hyphens (-). The maximum length is 100 characters.
# * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
# hyphens (-), or underscores (_). The maximum length is 500 characters.
- "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
- #
- # For App Engine queues, this is when the task will be attempted or retried.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
- # respond by this deadline then the request is cancelled and the attempt
- # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
- # task according to the RetryConfig.
- #
- # Note that when the request is cancelled, Cloud Tasks will stop listing for
- # the response, but whether the worker stops processing depends on the
- # worker. For example, if the worker is stuck, it may not react to cancelled
- # requests.
- #
- # The default and maximum values depend on the type of request:
- #
- # * For HTTP tasks, the default is 10 minutes. The deadline
- # must be in the interval [15 seconds, 30 minutes].
- #
- # * For App Engine tasks, 0 indicates that the
- # request has the default deadline. The default deadline depends on the
- # [scaling
- # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
- # of the service: 10 minutes for standard apps with automatic scaling, 24
- # hours for standard apps with manual and basic scaling, and 60 minutes for
- # flex apps. If the request deadline is set, it must be in the interval [15
- # seconds, 24 hours 15 seconds]. Regardless of the task's
- # `dispatch_deadline`, the app handler will not run for longer than than
- # the service's timeout. We recommend setting the `dispatch_deadline` to
- # at most a few seconds more than the app handler's timeout. For more
- # information see
- # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
- #
- # `dispatch_deadline` will be truncated to the nearest millisecond. The
- # deadline is an approximate deadline.
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
- "createTime": "A String", # Output only. The time that the task was created.
- #
- # `create_time` will be truncated to the nearest second.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
- "responseCount": 42, # Output only. The number of attempts which have received a response.
},
+ "responseView": "A String", # The response_view specifies which subset of the Task will be
+ # returned.
+ #
+ # By default response_view is BASIC; not all
+ # information is retrieved by default because some data, such as
+ # payloads, might be desirable to return only when needed because
+ # of its large size or because of the sensitivity of data that it
+ # contains.
+ #
+ # Authorization for FULL requires
+ # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+ # permission on the Task resource.
}
x__xgafv: string, V1 error format.
@@ -618,123 +618,110 @@
An object of the form:
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+ # respond by this deadline then the request is cancelled and the attempt
+ # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+ # task according to the RetryConfig.
#
- # An HTTP task is a task that has HttpRequest set.
+ # Note that when the request is cancelled, Cloud Tasks will stop listing for
+ # the response, but whether the worker stops processing depends on the
+ # worker. For example, if the worker is stuck, it may not react to cancelled
+ # requests.
#
- # The task will be pushed to the worker as an HTTP request. If the worker
- # or the redirected worker acknowledges the task by returning a successful HTTP
- # response code ([`200` - `299`]), the task will be removed from the queue. If
- # any other HTTP response code is returned or no response is received, the
- # task will be retried according to the following:
+ # The default and maximum values depend on the type of request:
#
- # * User-specified throttling: retry configuration,
- # rate limits, and the queue's state.
+ # * For HTTP tasks, the default is 10 minutes. The deadline
+ # must be in the interval [15 seconds, 30 minutes].
#
- # * System throttling: To prevent the worker from overloading, Cloud Tasks may
- # temporarily reduce the queue's effective rate. User-specified settings
- # will not be changed.
+ # * For App Engine tasks, 0 indicates that the
+ # request has the default deadline. The default deadline depends on the
+ # [scaling
+ # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
+ # of the service: 10 minutes for standard apps with automatic scaling, 24
+ # hours for standard apps with manual and basic scaling, and 60 minutes for
+ # flex apps. If the request deadline is set, it must be in the interval [15
+ # seconds, 24 hours 15 seconds]. Regardless of the task's
+ # `dispatch_deadline`, the app handler will not run for longer than than
+ # the service's timeout. We recommend setting the `dispatch_deadline` to
+ # at most a few seconds more than the app handler's timeout. For more
+ # information see
+ # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
#
- # System throttling happens because:
+ # `dispatch_deadline` will be truncated to the nearest millisecond. The
+ # deadline is an approximate deadline.
+ "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
- # * Cloud Tasks backs off on all errors. Normally the backoff specified in
- # rate limits will be used. But if the worker returns
- # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
- # errors is high, Cloud Tasks will use a higher backoff rate. The retry
- # specified in the `Retry-After` HTTP response header is considered.
- #
- # * To prevent traffic spikes and to smooth sudden increases in traffic,
- # dispatches ramp up slowly when the queue is newly created or idle and
- # if large numbers of tasks suddenly become available to dispatch (due to
- # spikes in create task rates, the queue being unpaused, or many tasks
- # that are scheduled at the same time).
- "body": "A String", # HTTP request body.
+ # Only dispatch_time will be set.
+ # The other Attempt information is not retained by Cloud Tasks.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
#
- # A request body is allowed only if the
- # HTTP method is POST, PUT, or PATCH. It is an
- # error to set body on a task with an incompatible HttpMethod.
- "headers": { # HTTP request headers.
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
#
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
#
- # These headers represent a subset of the headers that will accompany the
- # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
#
- # A partial list of headers that will be ignored or replaced is:
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
#
- # * Host: This will be computed by Cloud Tasks and derived from
- # HttpRequest.url.
- # * Content-Length: This will be computed by Cloud Tasks.
- # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
- # * X-Google-*: Google use only.
- # * X-AppEngine-*: Google use only.
- #
- # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
- # `Content-Type` to a media type when the
- # task is created.
- # For example, `Content-Type` can be set to `"application/octet-stream"` or
- # `"application/json"`.
- #
- # Headers which can have multiple values (according to RFC2616) can be
- # specified using comma-separated values.
- #
- # The size of the headers must be less than 80KB.
- "a_key": "A String",
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
- "url": "A String", # Required. The full url path that the request will be sent to.
- #
- # This string must begin with either "http://" or "https://". Some examples
- # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
- # encode some characters for safety and compatibility. The maximum allowed
- # URL length is 2083 characters after encoding.
- #
- # The `Location` header response from a redirect response [`300` - `399`]
- # may be followed. The redirect is not counted as a separate attempt.
- "oidcToken": { # Contains information needed for generating an # If specified, an
- # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
- # token will be generated and attached as an `Authorization` header in the
- # HTTP request.
- #
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- # [OpenID Connect
- # token](https://developers.google.com/identity/protocols/OpenIDConnect).
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OIDC token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "oauthToken": { # Contains information needed for generating an # If specified, an
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
- # will be generated and attached as an `Authorization` header in the HTTP
- # request.
- #
- # This type of authorization should generally only be used when calling
- # Google APIs hosted on *.googleapis.com.
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
- # This type of authorization should generally only be used when calling Google
- # APIs hosted on *.googleapis.com.
- "scope": "A String", # OAuth scope to be used for generating OAuth access token.
- # If not specified, "https://www.googleapis.com/auth/cloud-platform"
- # will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OAuth token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
},
- "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ #
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
+ #
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ #
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ },
+ },
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
+ "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
#
# An App Engine task is a task that has AppEngineHttpRequest set.
#
@@ -786,112 +773,18 @@
# required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
# Task dispatches also do not follow redirects.
#
- # The task attempt has succeeded if the app's request handler returns an HTTP
+ # The task attempt has succeeded if the app's request handler returns an HTTP
# response code in the range [`200` - `299`]. The task attempt has failed if
- # the app's handler returns a non-2xx response code or Cloud Tasks does
+ # the app's handler returns a non-2xx response code or Cloud Tasks does
# not receive response before the deadline. Failed
# tasks will be retried according to the
# retry configuration. `503` (Service Unavailable) is
# considered an App Engine system error instead of an application error and
- # will cause Cloud Tasks' traffic congestion control to temporarily throttle
- # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+ # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+ # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
# Requests) response from an app handler does not cause traffic congestion
# control to throttle the queue.
- "body": "A String", # HTTP request body.
- #
- # A request body is allowed only if the HTTP method is POST or PUT. It is
- # an error to set a body on a task with an incompatible HttpMethod.
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- #
- # The app's request handler for the task's target URL must be able to handle
- # HTTP requests with this http_method, otherwise the task attempt fails with
- # error code 405 (Method Not Allowed). See [Writing a push task request
- # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
- # and the App Engine documentation for your runtime on [How Requests are
- # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # If set,
- # app_engine_routing_override
- # is used for all tasks in the queue, no matter what the setting is for the
- # task-level app_engine_routing.
- #
- # Defines routing characteristics specific to App Engine - service, version,
- # and instance.
- #
- # For more information about services, versions, and instances see
- # [An Overview of App
- # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
- # [Microservices Architecture on Google App
- # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
- # [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).
- "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).
- "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).
- "version": "A String", # App version.
- #
- # By default, the task is sent to the version which is the default
- # version when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- "service": "A String", # App service.
- #
- # By default, the task is sent to the service which is the default
- # service when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- },
- "relativeUri": "A String", # The relative URI.
- #
- # The relative URI must begin with "/" and must be a valid HTTP relative URI.
- # It can contain a path and query string arguments.
- # If the relative URI is empty, then the root path "/" will be used.
- # No spaces are allowed, and the maximum length allowed is 2083 characters.
- "headers": { # HTTP request headers.
+ "headers": { # HTTP request headers.
#
# This map contains the header field names and values.
# Headers can be set when the
@@ -901,19 +794,19 @@
# Cloud Tasks sets some headers to default values:
#
# * `User-Agent`: By default, this header is
- # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
# This header can be modified, but Cloud Tasks will append
- # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
# modified `User-Agent`.
#
# If the task has a body, Cloud
# Tasks sets the following headers:
#
# * `Content-Type`: By default, the `Content-Type` header is set to
- # `"application/octet-stream"`. The default can be overridden by explicitly
+ # `"application/octet-stream"`. The default can be overridden by explicitly
# setting `Content-Type` to a particular media type when the
# task is created.
- # For example, `Content-Type` can be set to `"application/json"`.
+ # For example, `Content-Type` can be set to `"application/json"`.
# * `Content-Length`: This is computed by Cloud Tasks. This value is
# output only. It cannot be changed.
#
@@ -933,77 +826,230 @@
# Although there is no specific limit for the maximum number of headers or
# the size, there is a limit on the maximum size of the Task. For more
# information, see the CreateTask documentation.
- "a_key": "A String",
+ "a_key": "A String",
},
+ "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+ #
+ # If set,
+ # app_engine_routing_override
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level app_engine_routing.
+ #
+ # Defines routing characteristics specific to App Engine - service, version,
+ # and instance.
+ #
+ # For more information about services, versions, and instances see
+ # [An Overview of App
+ # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+ # [Microservices Architecture on Google App
+ # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+ # [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
+ # version when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ "service": "A String", # App service.
+ #
+ # By default, the task is sent to the service which is the default
+ # service when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ #
+ # The app's request handler for the task's target URL must be able to handle
+ # HTTP requests with this http_method, otherwise the task attempt fails with
+ # error code 405 (Method Not Allowed). See [Writing a push task request
+ # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+ # and the App Engine documentation for your runtime on [How Requests are
+ # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
+ "body": "A String", # HTTP request body.
+ #
+ # A request body is allowed only if the HTTP method is POST or PUT. It is
+ # an error to set a body on a task with an incompatible HttpMethod.
+ "relativeUri": "A String", # The relative URI.
+ #
+ # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+ # It can contain a path and query string arguments.
+ # If the relative URI is empty, then the root path "/" will be used.
+ # No spaces are allowed, and the maximum length allowed is 2083 characters.
},
- "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "createTime": "A String", # Output only. The time that the task was created.
#
- # Only dispatch_time will be set.
- # The other Attempt information is not retained by Cloud Tasks.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ # `create_time` will be truncated to the nearest second.
+ "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+ #
+ # For App Engine queues, this is when the task will be attempted or retried.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ #
+ # An HTTP task is a task that has HttpRequest set.
+ #
+ # The task will be pushed to the worker as an HTTP request. If the worker
+ # or the redirected worker acknowledges the task by returning a successful HTTP
+ # response code ([`200` - `299`]), the task will be removed from the queue. If
+ # any other HTTP response code is returned or no response is received, the
+ # task will be retried according to the following:
+ #
+ # * User-specified throttling: retry configuration,
+ # rate limits, and the queue's state.
+ #
+ # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+ # temporarily reduce the queue's effective rate. User-specified settings
+ # will not be changed.
+ #
+ # System throttling happens because:
+ #
+ # * Cloud Tasks backs off on all errors. Normally the backoff specified in
+ # rate limits will be used. But if the worker returns
+ # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+ # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+ # specified in the `Retry-After` HTTP response header is considered.
+ #
+ # * To prevent traffic spikes and to smooth sudden increases in traffic,
+ # dispatches ramp up slowly when the queue is newly created or idle and
+ # if large numbers of tasks suddenly become available to dispatch (due to
+ # spikes in create task rates, the queue being unpaused, or many tasks
+ # that are scheduled at the same time).
+ "url": "A String", # Required. The full url path that the request will be sent to.
#
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ # This string must begin with either "http://" or "https://". Some examples
+ # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+ # encode some characters for safety and compatibility. The maximum allowed
+ # URL length is 2083 characters after encoding.
#
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
+ # The `Location` header response from a redirect response [`300` - `399`]
+ # may be followed. The redirect is not counted as a separate attempt.
+ "oidcToken": { # Contains information needed for generating an # If specified, an
+ # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+ # token will be generated and attached as an `Authorization` header in the
+ # HTTP request.
#
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ # [OpenID Connect
+ # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OIDC token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "body": "A String", # HTTP request body.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # A request body is allowed only if the
+ # HTTP method is POST, PUT, or PATCH. It is an
+ # error to set body on a task with an incompatible HttpMethod.
+ "oauthToken": { # Contains information needed for generating an # If specified, an
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+ # will be generated and attached as an `Authorization` header in the HTTP
+ # request.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
- },
- "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
- #
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization should generally only be used when calling
+ # Google APIs hosted on *.googleapis.com.
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+ # This type of authorization should generally only be used when calling Google
+ # APIs hosted on *.googleapis.com.
+ "scope": "A String", # OAuth scope to be used for generating OAuth access token.
+ # If not specified, "https://www.googleapis.com/auth/cloud-platform"
+ # will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OAuth token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "headers": { # HTTP request headers.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
+ # These headers represent a subset of the headers that will accompany the
+ # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ #
+ # A partial list of headers that will be ignored or replaced is:
+ #
+ # * Host: This will be computed by Cloud Tasks and derived from
+ # HttpRequest.url.
+ # * Content-Length: This will be computed by Cloud Tasks.
+ # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+ # * X-Google-*: Google use only.
+ # * X-AppEngine-*: Google use only.
+ #
+ # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+ # `Content-Type` to a media type when the
+ # task is created.
+ # For example, `Content-Type` can be set to `"application/octet-stream"` or
+ # `"application/json"`.
+ #
+ # Headers which can have multiple values (according to RFC2616) can be
+ # specified using comma-separated values.
+ #
+ # The size of the headers must be less than 80KB.
+ "a_key": "A String",
+ },
},
- "name": "A String", # Optionally caller-specified in CreateTask.
+ "name": "A String", # Optionally caller-specified in CreateTask.
#
# The task name.
#
@@ -1015,7 +1061,7 @@
# 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 task's location.
+ # * `LOCATION_ID` is the canonical ID for the task's location.
# The list of available locations can be obtained by calling
# ListLocations.
# For more information, see https://cloud.google.com/about/locations/.
@@ -1023,52 +1069,6 @@
# hyphens (-). The maximum length is 100 characters.
# * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
# hyphens (-), or underscores (_). The maximum length is 500 characters.
- "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
- #
- # For App Engine queues, this is when the task will be attempted or retried.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
- # respond by this deadline then the request is cancelled and the attempt
- # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
- # task according to the RetryConfig.
- #
- # Note that when the request is cancelled, Cloud Tasks will stop listing for
- # the response, but whether the worker stops processing depends on the
- # worker. For example, if the worker is stuck, it may not react to cancelled
- # requests.
- #
- # The default and maximum values depend on the type of request:
- #
- # * For HTTP tasks, the default is 10 minutes. The deadline
- # must be in the interval [15 seconds, 30 minutes].
- #
- # * For App Engine tasks, 0 indicates that the
- # request has the default deadline. The default deadline depends on the
- # [scaling
- # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
- # of the service: 10 minutes for standard apps with automatic scaling, 24
- # hours for standard apps with manual and basic scaling, and 60 minutes for
- # flex apps. If the request deadline is set, it must be in the interval [15
- # seconds, 24 hours 15 seconds]. Regardless of the task's
- # `dispatch_deadline`, the app handler will not run for longer than than
- # the service's timeout. We recommend setting the `dispatch_deadline` to
- # at most a few seconds more than the app handler's timeout. For more
- # information see
- # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
- #
- # `dispatch_deadline` will be truncated to the nearest millisecond. The
- # deadline is an approximate deadline.
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
- "createTime": "A String", # Output only. The time that the task was created.
- #
- # `create_time` will be truncated to the nearest second.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
- "responseCount": 42, # Output only. The number of attempts which have received a response.
}</pre>
</div>
@@ -1131,123 +1131,110 @@
An object of the form:
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+ # respond by this deadline then the request is cancelled and the attempt
+ # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+ # task according to the RetryConfig.
#
- # An HTTP task is a task that has HttpRequest set.
+ # Note that when the request is cancelled, Cloud Tasks will stop listing for
+ # the response, but whether the worker stops processing depends on the
+ # worker. For example, if the worker is stuck, it may not react to cancelled
+ # requests.
#
- # The task will be pushed to the worker as an HTTP request. If the worker
- # or the redirected worker acknowledges the task by returning a successful HTTP
- # response code ([`200` - `299`]), the task will be removed from the queue. If
- # any other HTTP response code is returned or no response is received, the
- # task will be retried according to the following:
+ # The default and maximum values depend on the type of request:
#
- # * User-specified throttling: retry configuration,
- # rate limits, and the queue's state.
+ # * For HTTP tasks, the default is 10 minutes. The deadline
+ # must be in the interval [15 seconds, 30 minutes].
#
- # * System throttling: To prevent the worker from overloading, Cloud Tasks may
- # temporarily reduce the queue's effective rate. User-specified settings
- # will not be changed.
+ # * For App Engine tasks, 0 indicates that the
+ # request has the default deadline. The default deadline depends on the
+ # [scaling
+ # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
+ # of the service: 10 minutes for standard apps with automatic scaling, 24
+ # hours for standard apps with manual and basic scaling, and 60 minutes for
+ # flex apps. If the request deadline is set, it must be in the interval [15
+ # seconds, 24 hours 15 seconds]. Regardless of the task's
+ # `dispatch_deadline`, the app handler will not run for longer than than
+ # the service's timeout. We recommend setting the `dispatch_deadline` to
+ # at most a few seconds more than the app handler's timeout. For more
+ # information see
+ # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
#
- # System throttling happens because:
+ # `dispatch_deadline` will be truncated to the nearest millisecond. The
+ # deadline is an approximate deadline.
+ "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
- # * Cloud Tasks backs off on all errors. Normally the backoff specified in
- # rate limits will be used. But if the worker returns
- # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
- # errors is high, Cloud Tasks will use a higher backoff rate. The retry
- # specified in the `Retry-After` HTTP response header is considered.
- #
- # * To prevent traffic spikes and to smooth sudden increases in traffic,
- # dispatches ramp up slowly when the queue is newly created or idle and
- # if large numbers of tasks suddenly become available to dispatch (due to
- # spikes in create task rates, the queue being unpaused, or many tasks
- # that are scheduled at the same time).
- "body": "A String", # HTTP request body.
+ # Only dispatch_time will be set.
+ # The other Attempt information is not retained by Cloud Tasks.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
#
- # A request body is allowed only if the
- # HTTP method is POST, PUT, or PATCH. It is an
- # error to set body on a task with an incompatible HttpMethod.
- "headers": { # HTTP request headers.
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
#
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
#
- # These headers represent a subset of the headers that will accompany the
- # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
#
- # A partial list of headers that will be ignored or replaced is:
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
#
- # * Host: This will be computed by Cloud Tasks and derived from
- # HttpRequest.url.
- # * Content-Length: This will be computed by Cloud Tasks.
- # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
- # * X-Google-*: Google use only.
- # * X-AppEngine-*: Google use only.
- #
- # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
- # `Content-Type` to a media type when the
- # task is created.
- # For example, `Content-Type` can be set to `"application/octet-stream"` or
- # `"application/json"`.
- #
- # Headers which can have multiple values (according to RFC2616) can be
- # specified using comma-separated values.
- #
- # The size of the headers must be less than 80KB.
- "a_key": "A String",
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
- "url": "A String", # Required. The full url path that the request will be sent to.
- #
- # This string must begin with either "http://" or "https://". Some examples
- # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
- # encode some characters for safety and compatibility. The maximum allowed
- # URL length is 2083 characters after encoding.
- #
- # The `Location` header response from a redirect response [`300` - `399`]
- # may be followed. The redirect is not counted as a separate attempt.
- "oidcToken": { # Contains information needed for generating an # If specified, an
- # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
- # token will be generated and attached as an `Authorization` header in the
- # HTTP request.
- #
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- # [OpenID Connect
- # token](https://developers.google.com/identity/protocols/OpenIDConnect).
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OIDC token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "oauthToken": { # Contains information needed for generating an # If specified, an
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
- # will be generated and attached as an `Authorization` header in the HTTP
- # request.
- #
- # This type of authorization should generally only be used when calling
- # Google APIs hosted on *.googleapis.com.
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
- # This type of authorization should generally only be used when calling Google
- # APIs hosted on *.googleapis.com.
- "scope": "A String", # OAuth scope to be used for generating OAuth access token.
- # If not specified, "https://www.googleapis.com/auth/cloud-platform"
- # will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OAuth token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
},
- "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ #
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
+ #
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ #
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ },
+ },
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
+ "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
#
# An App Engine task is a task that has AppEngineHttpRequest set.
#
@@ -1299,112 +1286,18 @@
# required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
# Task dispatches also do not follow redirects.
#
- # The task attempt has succeeded if the app's request handler returns an HTTP
+ # The task attempt has succeeded if the app's request handler returns an HTTP
# response code in the range [`200` - `299`]. The task attempt has failed if
- # the app's handler returns a non-2xx response code or Cloud Tasks does
+ # the app's handler returns a non-2xx response code or Cloud Tasks does
# not receive response before the deadline. Failed
# tasks will be retried according to the
# retry configuration. `503` (Service Unavailable) is
# considered an App Engine system error instead of an application error and
- # will cause Cloud Tasks' traffic congestion control to temporarily throttle
- # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+ # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+ # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
# Requests) response from an app handler does not cause traffic congestion
# control to throttle the queue.
- "body": "A String", # HTTP request body.
- #
- # A request body is allowed only if the HTTP method is POST or PUT. It is
- # an error to set a body on a task with an incompatible HttpMethod.
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- #
- # The app's request handler for the task's target URL must be able to handle
- # HTTP requests with this http_method, otherwise the task attempt fails with
- # error code 405 (Method Not Allowed). See [Writing a push task request
- # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
- # and the App Engine documentation for your runtime on [How Requests are
- # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # If set,
- # app_engine_routing_override
- # is used for all tasks in the queue, no matter what the setting is for the
- # task-level app_engine_routing.
- #
- # Defines routing characteristics specific to App Engine - service, version,
- # and instance.
- #
- # For more information about services, versions, and instances see
- # [An Overview of App
- # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
- # [Microservices Architecture on Google App
- # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
- # [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).
- "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).
- "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).
- "version": "A String", # App version.
- #
- # By default, the task is sent to the version which is the default
- # version when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- "service": "A String", # App service.
- #
- # By default, the task is sent to the service which is the default
- # service when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- },
- "relativeUri": "A String", # The relative URI.
- #
- # The relative URI must begin with "/" and must be a valid HTTP relative URI.
- # It can contain a path and query string arguments.
- # If the relative URI is empty, then the root path "/" will be used.
- # No spaces are allowed, and the maximum length allowed is 2083 characters.
- "headers": { # HTTP request headers.
+ "headers": { # HTTP request headers.
#
# This map contains the header field names and values.
# Headers can be set when the
@@ -1414,19 +1307,19 @@
# Cloud Tasks sets some headers to default values:
#
# * `User-Agent`: By default, this header is
- # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
# This header can be modified, but Cloud Tasks will append
- # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
# modified `User-Agent`.
#
# If the task has a body, Cloud
# Tasks sets the following headers:
#
# * `Content-Type`: By default, the `Content-Type` header is set to
- # `"application/octet-stream"`. The default can be overridden by explicitly
+ # `"application/octet-stream"`. The default can be overridden by explicitly
# setting `Content-Type` to a particular media type when the
# task is created.
- # For example, `Content-Type` can be set to `"application/json"`.
+ # For example, `Content-Type` can be set to `"application/json"`.
# * `Content-Length`: This is computed by Cloud Tasks. This value is
# output only. It cannot be changed.
#
@@ -1446,77 +1339,230 @@
# Although there is no specific limit for the maximum number of headers or
# the size, there is a limit on the maximum size of the Task. For more
# information, see the CreateTask documentation.
- "a_key": "A String",
+ "a_key": "A String",
},
+ "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+ #
+ # If set,
+ # app_engine_routing_override
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level app_engine_routing.
+ #
+ # Defines routing characteristics specific to App Engine - service, version,
+ # and instance.
+ #
+ # For more information about services, versions, and instances see
+ # [An Overview of App
+ # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+ # [Microservices Architecture on Google App
+ # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+ # [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
+ # version when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ "service": "A String", # App service.
+ #
+ # By default, the task is sent to the service which is the default
+ # service when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ #
+ # The app's request handler for the task's target URL must be able to handle
+ # HTTP requests with this http_method, otherwise the task attempt fails with
+ # error code 405 (Method Not Allowed). See [Writing a push task request
+ # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+ # and the App Engine documentation for your runtime on [How Requests are
+ # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
+ "body": "A String", # HTTP request body.
+ #
+ # A request body is allowed only if the HTTP method is POST or PUT. It is
+ # an error to set a body on a task with an incompatible HttpMethod.
+ "relativeUri": "A String", # The relative URI.
+ #
+ # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+ # It can contain a path and query string arguments.
+ # If the relative URI is empty, then the root path "/" will be used.
+ # No spaces are allowed, and the maximum length allowed is 2083 characters.
},
- "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "createTime": "A String", # Output only. The time that the task was created.
#
- # Only dispatch_time will be set.
- # The other Attempt information is not retained by Cloud Tasks.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ # `create_time` will be truncated to the nearest second.
+ "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+ #
+ # For App Engine queues, this is when the task will be attempted or retried.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ #
+ # An HTTP task is a task that has HttpRequest set.
+ #
+ # The task will be pushed to the worker as an HTTP request. If the worker
+ # or the redirected worker acknowledges the task by returning a successful HTTP
+ # response code ([`200` - `299`]), the task will be removed from the queue. If
+ # any other HTTP response code is returned or no response is received, the
+ # task will be retried according to the following:
+ #
+ # * User-specified throttling: retry configuration,
+ # rate limits, and the queue's state.
+ #
+ # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+ # temporarily reduce the queue's effective rate. User-specified settings
+ # will not be changed.
+ #
+ # System throttling happens because:
+ #
+ # * Cloud Tasks backs off on all errors. Normally the backoff specified in
+ # rate limits will be used. But if the worker returns
+ # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+ # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+ # specified in the `Retry-After` HTTP response header is considered.
+ #
+ # * To prevent traffic spikes and to smooth sudden increases in traffic,
+ # dispatches ramp up slowly when the queue is newly created or idle and
+ # if large numbers of tasks suddenly become available to dispatch (due to
+ # spikes in create task rates, the queue being unpaused, or many tasks
+ # that are scheduled at the same time).
+ "url": "A String", # Required. The full url path that the request will be sent to.
#
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ # This string must begin with either "http://" or "https://". Some examples
+ # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+ # encode some characters for safety and compatibility. The maximum allowed
+ # URL length is 2083 characters after encoding.
#
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
+ # The `Location` header response from a redirect response [`300` - `399`]
+ # may be followed. The redirect is not counted as a separate attempt.
+ "oidcToken": { # Contains information needed for generating an # If specified, an
+ # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+ # token will be generated and attached as an `Authorization` header in the
+ # HTTP request.
#
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ # [OpenID Connect
+ # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OIDC token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "body": "A String", # HTTP request body.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # A request body is allowed only if the
+ # HTTP method is POST, PUT, or PATCH. It is an
+ # error to set body on a task with an incompatible HttpMethod.
+ "oauthToken": { # Contains information needed for generating an # If specified, an
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+ # will be generated and attached as an `Authorization` header in the HTTP
+ # request.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
- },
- "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
- #
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization should generally only be used when calling
+ # Google APIs hosted on *.googleapis.com.
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+ # This type of authorization should generally only be used when calling Google
+ # APIs hosted on *.googleapis.com.
+ "scope": "A String", # OAuth scope to be used for generating OAuth access token.
+ # If not specified, "https://www.googleapis.com/auth/cloud-platform"
+ # will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OAuth token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "headers": { # HTTP request headers.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
+ # These headers represent a subset of the headers that will accompany the
+ # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ #
+ # A partial list of headers that will be ignored or replaced is:
+ #
+ # * Host: This will be computed by Cloud Tasks and derived from
+ # HttpRequest.url.
+ # * Content-Length: This will be computed by Cloud Tasks.
+ # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+ # * X-Google-*: Google use only.
+ # * X-AppEngine-*: Google use only.
+ #
+ # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+ # `Content-Type` to a media type when the
+ # task is created.
+ # For example, `Content-Type` can be set to `"application/octet-stream"` or
+ # `"application/json"`.
+ #
+ # Headers which can have multiple values (according to RFC2616) can be
+ # specified using comma-separated values.
+ #
+ # The size of the headers must be less than 80KB.
+ "a_key": "A String",
+ },
},
- "name": "A String", # Optionally caller-specified in CreateTask.
+ "name": "A String", # Optionally caller-specified in CreateTask.
#
# The task name.
#
@@ -1528,7 +1574,7 @@
# 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 task's location.
+ # * `LOCATION_ID` is the canonical ID for the task's location.
# The list of available locations can be obtained by calling
# ListLocations.
# For more information, see https://cloud.google.com/about/locations/.
@@ -1536,57 +1582,11 @@
# hyphens (-). The maximum length is 100 characters.
# * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
# hyphens (-), or underscores (_). The maximum length is 500 characters.
- "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
- #
- # For App Engine queues, this is when the task will be attempted or retried.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
- # respond by this deadline then the request is cancelled and the attempt
- # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
- # task according to the RetryConfig.
- #
- # Note that when the request is cancelled, Cloud Tasks will stop listing for
- # the response, but whether the worker stops processing depends on the
- # worker. For example, if the worker is stuck, it may not react to cancelled
- # requests.
- #
- # The default and maximum values depend on the type of request:
- #
- # * For HTTP tasks, the default is 10 minutes. The deadline
- # must be in the interval [15 seconds, 30 minutes].
- #
- # * For App Engine tasks, 0 indicates that the
- # request has the default deadline. The default deadline depends on the
- # [scaling
- # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
- # of the service: 10 minutes for standard apps with automatic scaling, 24
- # hours for standard apps with manual and basic scaling, and 60 minutes for
- # flex apps. If the request deadline is set, it must be in the interval [15
- # seconds, 24 hours 15 seconds]. Regardless of the task's
- # `dispatch_deadline`, the app handler will not run for longer than than
- # the service's timeout. We recommend setting the `dispatch_deadline` to
- # at most a few seconds more than the app handler's timeout. For more
- # information see
- # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
- #
- # `dispatch_deadline` will be truncated to the nearest millisecond. The
- # deadline is an approximate deadline.
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
- "createTime": "A String", # Output only. The time that the task was created.
- #
- # `create_time` will be truncated to the nearest second.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
- "responseCount": 42, # Output only. The number of attempts which have received a response.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, responseView=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, responseView=None, pageToken=None, pageSize=None, x__xgafv=None)</code>
<pre>Lists the tasks in a queue.
By default, only the BASIC view is retrieved
@@ -1612,14 +1612,6 @@
Authorization for FULL requires
`cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
permission on the Task resource.
- pageSize: integer, Maximum page size.
-
-Fewer tasks than requested might be returned, even if more tasks exist; use
-next_page_token in the response to
-determine if more tasks exist.
-
-The maximum page size is 1000. If unspecified, the page size will be the
-maximum.
pageToken: string, A token identifying the page of results to return.
To request the first page results, page_token must be empty. To
@@ -1629,6 +1621,14 @@
method.
The page token is valid for only 2 hours.
+ pageSize: integer, Maximum page size.
+
+Fewer tasks than requested might be returned, even if more tasks exist; use
+next_page_token in the response to
+determine if more tasks exist.
+
+The maximum page size is 1000. If unspecified, the page size will be the
+maximum.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -1638,132 +1638,112 @@
An object of the form:
{ # Response message for listing tasks using ListTasks.
- "nextPageToken": "A String", # A token to retrieve next page of results.
- #
- # To return the next page of results, call
- # ListTasks with this value as the
- # page_token.
- #
- # If the next_page_token is empty, there are no more results.
- "tasks": [ # The list of tasks.
+ "tasks": [ # The list of tasks.
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+ # respond by this deadline then the request is cancelled and the attempt
+ # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+ # task according to the RetryConfig.
#
- # An HTTP task is a task that has HttpRequest set.
+ # Note that when the request is cancelled, Cloud Tasks will stop listing for
+ # the response, but whether the worker stops processing depends on the
+ # worker. For example, if the worker is stuck, it may not react to cancelled
+ # requests.
#
- # The task will be pushed to the worker as an HTTP request. If the worker
- # or the redirected worker acknowledges the task by returning a successful HTTP
- # response code ([`200` - `299`]), the task will be removed from the queue. If
- # any other HTTP response code is returned or no response is received, the
- # task will be retried according to the following:
+ # The default and maximum values depend on the type of request:
#
- # * User-specified throttling: retry configuration,
- # rate limits, and the queue's state.
+ # * For HTTP tasks, the default is 10 minutes. The deadline
+ # must be in the interval [15 seconds, 30 minutes].
#
- # * System throttling: To prevent the worker from overloading, Cloud Tasks may
- # temporarily reduce the queue's effective rate. User-specified settings
- # will not be changed.
+ # * For App Engine tasks, 0 indicates that the
+ # request has the default deadline. The default deadline depends on the
+ # [scaling
+ # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
+ # of the service: 10 minutes for standard apps with automatic scaling, 24
+ # hours for standard apps with manual and basic scaling, and 60 minutes for
+ # flex apps. If the request deadline is set, it must be in the interval [15
+ # seconds, 24 hours 15 seconds]. Regardless of the task's
+ # `dispatch_deadline`, the app handler will not run for longer than than
+ # the service's timeout. We recommend setting the `dispatch_deadline` to
+ # at most a few seconds more than the app handler's timeout. For more
+ # information see
+ # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
#
- # System throttling happens because:
+ # `dispatch_deadline` will be truncated to the nearest millisecond. The
+ # deadline is an approximate deadline.
+ "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
- # * Cloud Tasks backs off on all errors. Normally the backoff specified in
- # rate limits will be used. But if the worker returns
- # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
- # errors is high, Cloud Tasks will use a higher backoff rate. The retry
- # specified in the `Retry-After` HTTP response header is considered.
- #
- # * To prevent traffic spikes and to smooth sudden increases in traffic,
- # dispatches ramp up slowly when the queue is newly created or idle and
- # if large numbers of tasks suddenly become available to dispatch (due to
- # spikes in create task rates, the queue being unpaused, or many tasks
- # that are scheduled at the same time).
- "body": "A String", # HTTP request body.
+ # Only dispatch_time will be set.
+ # The other Attempt information is not retained by Cloud Tasks.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
#
- # A request body is allowed only if the
- # HTTP method is POST, PUT, or PATCH. It is an
- # error to set body on a task with an incompatible HttpMethod.
- "headers": { # HTTP request headers.
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
#
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
#
- # These headers represent a subset of the headers that will accompany the
- # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
#
- # A partial list of headers that will be ignored or replaced is:
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
#
- # * Host: This will be computed by Cloud Tasks and derived from
- # HttpRequest.url.
- # * Content-Length: This will be computed by Cloud Tasks.
- # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
- # * X-Google-*: Google use only.
- # * X-AppEngine-*: Google use only.
- #
- # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
- # `Content-Type` to a media type when the
- # task is created.
- # For example, `Content-Type` can be set to `"application/octet-stream"` or
- # `"application/json"`.
- #
- # Headers which can have multiple values (according to RFC2616) can be
- # specified using comma-separated values.
- #
- # The size of the headers must be less than 80KB.
- "a_key": "A String",
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
- "url": "A String", # Required. The full url path that the request will be sent to.
- #
- # This string must begin with either "http://" or "https://". Some examples
- # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
- # encode some characters for safety and compatibility. The maximum allowed
- # URL length is 2083 characters after encoding.
- #
- # The `Location` header response from a redirect response [`300` - `399`]
- # may be followed. The redirect is not counted as a separate attempt.
- "oidcToken": { # Contains information needed for generating an # If specified, an
- # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
- # token will be generated and attached as an `Authorization` header in the
- # HTTP request.
- #
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- # [OpenID Connect
- # token](https://developers.google.com/identity/protocols/OpenIDConnect).
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OIDC token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "oauthToken": { # Contains information needed for generating an # If specified, an
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
- # will be generated and attached as an `Authorization` header in the HTTP
- # request.
- #
- # This type of authorization should generally only be used when calling
- # Google APIs hosted on *.googleapis.com.
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
- # This type of authorization should generally only be used when calling Google
- # APIs hosted on *.googleapis.com.
- "scope": "A String", # OAuth scope to be used for generating OAuth access token.
- # If not specified, "https://www.googleapis.com/auth/cloud-platform"
- # will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OAuth token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
},
- "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ #
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
+ #
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ #
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ },
+ },
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
+ "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
#
# An App Engine task is a task that has AppEngineHttpRequest set.
#
@@ -1815,112 +1795,18 @@
# required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
# Task dispatches also do not follow redirects.
#
- # The task attempt has succeeded if the app's request handler returns an HTTP
+ # The task attempt has succeeded if the app's request handler returns an HTTP
# response code in the range [`200` - `299`]. The task attempt has failed if
- # the app's handler returns a non-2xx response code or Cloud Tasks does
+ # the app's handler returns a non-2xx response code or Cloud Tasks does
# not receive response before the deadline. Failed
# tasks will be retried according to the
# retry configuration. `503` (Service Unavailable) is
# considered an App Engine system error instead of an application error and
- # will cause Cloud Tasks' traffic congestion control to temporarily throttle
- # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+ # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+ # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
# Requests) response from an app handler does not cause traffic congestion
# control to throttle the queue.
- "body": "A String", # HTTP request body.
- #
- # A request body is allowed only if the HTTP method is POST or PUT. It is
- # an error to set a body on a task with an incompatible HttpMethod.
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- #
- # The app's request handler for the task's target URL must be able to handle
- # HTTP requests with this http_method, otherwise the task attempt fails with
- # error code 405 (Method Not Allowed). See [Writing a push task request
- # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
- # and the App Engine documentation for your runtime on [How Requests are
- # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # If set,
- # app_engine_routing_override
- # is used for all tasks in the queue, no matter what the setting is for the
- # task-level app_engine_routing.
- #
- # Defines routing characteristics specific to App Engine - service, version,
- # and instance.
- #
- # For more information about services, versions, and instances see
- # [An Overview of App
- # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
- # [Microservices Architecture on Google App
- # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
- # [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).
- "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).
- "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).
- "version": "A String", # App version.
- #
- # By default, the task is sent to the version which is the default
- # version when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- "service": "A String", # App service.
- #
- # By default, the task is sent to the service which is the default
- # service when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- },
- "relativeUri": "A String", # The relative URI.
- #
- # The relative URI must begin with "/" and must be a valid HTTP relative URI.
- # It can contain a path and query string arguments.
- # If the relative URI is empty, then the root path "/" will be used.
- # No spaces are allowed, and the maximum length allowed is 2083 characters.
- "headers": { # HTTP request headers.
+ "headers": { # HTTP request headers.
#
# This map contains the header field names and values.
# Headers can be set when the
@@ -1930,19 +1816,19 @@
# Cloud Tasks sets some headers to default values:
#
# * `User-Agent`: By default, this header is
- # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
# This header can be modified, but Cloud Tasks will append
- # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
# modified `User-Agent`.
#
# If the task has a body, Cloud
# Tasks sets the following headers:
#
# * `Content-Type`: By default, the `Content-Type` header is set to
- # `"application/octet-stream"`. The default can be overridden by explicitly
+ # `"application/octet-stream"`. The default can be overridden by explicitly
# setting `Content-Type` to a particular media type when the
# task is created.
- # For example, `Content-Type` can be set to `"application/json"`.
+ # For example, `Content-Type` can be set to `"application/json"`.
# * `Content-Length`: This is computed by Cloud Tasks. This value is
# output only. It cannot be changed.
#
@@ -1962,77 +1848,230 @@
# Although there is no specific limit for the maximum number of headers or
# the size, there is a limit on the maximum size of the Task. For more
# information, see the CreateTask documentation.
- "a_key": "A String",
+ "a_key": "A String",
},
+ "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+ #
+ # If set,
+ # app_engine_routing_override
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level app_engine_routing.
+ #
+ # Defines routing characteristics specific to App Engine - service, version,
+ # and instance.
+ #
+ # For more information about services, versions, and instances see
+ # [An Overview of App
+ # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+ # [Microservices Architecture on Google App
+ # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+ # [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
+ # version when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ "service": "A String", # App service.
+ #
+ # By default, the task is sent to the service which is the default
+ # service when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ #
+ # The app's request handler for the task's target URL must be able to handle
+ # HTTP requests with this http_method, otherwise the task attempt fails with
+ # error code 405 (Method Not Allowed). See [Writing a push task request
+ # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+ # and the App Engine documentation for your runtime on [How Requests are
+ # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
+ "body": "A String", # HTTP request body.
+ #
+ # A request body is allowed only if the HTTP method is POST or PUT. It is
+ # an error to set a body on a task with an incompatible HttpMethod.
+ "relativeUri": "A String", # The relative URI.
+ #
+ # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+ # It can contain a path and query string arguments.
+ # If the relative URI is empty, then the root path "/" will be used.
+ # No spaces are allowed, and the maximum length allowed is 2083 characters.
},
- "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "createTime": "A String", # Output only. The time that the task was created.
#
- # Only dispatch_time will be set.
- # The other Attempt information is not retained by Cloud Tasks.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ # `create_time` will be truncated to the nearest second.
+ "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+ #
+ # For App Engine queues, this is when the task will be attempted or retried.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ #
+ # An HTTP task is a task that has HttpRequest set.
+ #
+ # The task will be pushed to the worker as an HTTP request. If the worker
+ # or the redirected worker acknowledges the task by returning a successful HTTP
+ # response code ([`200` - `299`]), the task will be removed from the queue. If
+ # any other HTTP response code is returned or no response is received, the
+ # task will be retried according to the following:
+ #
+ # * User-specified throttling: retry configuration,
+ # rate limits, and the queue's state.
+ #
+ # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+ # temporarily reduce the queue's effective rate. User-specified settings
+ # will not be changed.
+ #
+ # System throttling happens because:
+ #
+ # * Cloud Tasks backs off on all errors. Normally the backoff specified in
+ # rate limits will be used. But if the worker returns
+ # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+ # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+ # specified in the `Retry-After` HTTP response header is considered.
+ #
+ # * To prevent traffic spikes and to smooth sudden increases in traffic,
+ # dispatches ramp up slowly when the queue is newly created or idle and
+ # if large numbers of tasks suddenly become available to dispatch (due to
+ # spikes in create task rates, the queue being unpaused, or many tasks
+ # that are scheduled at the same time).
+ "url": "A String", # Required. The full url path that the request will be sent to.
#
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ # This string must begin with either "http://" or "https://". Some examples
+ # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+ # encode some characters for safety and compatibility. The maximum allowed
+ # URL length is 2083 characters after encoding.
#
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
+ # The `Location` header response from a redirect response [`300` - `399`]
+ # may be followed. The redirect is not counted as a separate attempt.
+ "oidcToken": { # Contains information needed for generating an # If specified, an
+ # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+ # token will be generated and attached as an `Authorization` header in the
+ # HTTP request.
#
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ # [OpenID Connect
+ # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OIDC token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "body": "A String", # HTTP request body.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # A request body is allowed only if the
+ # HTTP method is POST, PUT, or PATCH. It is an
+ # error to set body on a task with an incompatible HttpMethod.
+ "oauthToken": { # Contains information needed for generating an # If specified, an
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+ # will be generated and attached as an `Authorization` header in the HTTP
+ # request.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
- },
- "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
- #
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization should generally only be used when calling
+ # Google APIs hosted on *.googleapis.com.
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+ # This type of authorization should generally only be used when calling Google
+ # APIs hosted on *.googleapis.com.
+ "scope": "A String", # OAuth scope to be used for generating OAuth access token.
+ # If not specified, "https://www.googleapis.com/auth/cloud-platform"
+ # will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OAuth token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "headers": { # HTTP request headers.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
+ # These headers represent a subset of the headers that will accompany the
+ # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ #
+ # A partial list of headers that will be ignored or replaced is:
+ #
+ # * Host: This will be computed by Cloud Tasks and derived from
+ # HttpRequest.url.
+ # * Content-Length: This will be computed by Cloud Tasks.
+ # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+ # * X-Google-*: Google use only.
+ # * X-AppEngine-*: Google use only.
+ #
+ # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+ # `Content-Type` to a media type when the
+ # task is created.
+ # For example, `Content-Type` can be set to `"application/octet-stream"` or
+ # `"application/json"`.
+ #
+ # Headers which can have multiple values (according to RFC2616) can be
+ # specified using comma-separated values.
+ #
+ # The size of the headers must be less than 80KB.
+ "a_key": "A String",
+ },
},
- "name": "A String", # Optionally caller-specified in CreateTask.
+ "name": "A String", # Optionally caller-specified in CreateTask.
#
# The task name.
#
@@ -2044,7 +2083,7 @@
# 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 task's location.
+ # * `LOCATION_ID` is the canonical ID for the task's location.
# The list of available locations can be obtained by calling
# ListLocations.
# For more information, see https://cloud.google.com/about/locations/.
@@ -2052,54 +2091,15 @@
# hyphens (-). The maximum length is 100 characters.
# * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
# hyphens (-), or underscores (_). The maximum length is 500 characters.
- "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
- #
- # For App Engine queues, this is when the task will be attempted or retried.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
- # respond by this deadline then the request is cancelled and the attempt
- # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
- # task according to the RetryConfig.
- #
- # Note that when the request is cancelled, Cloud Tasks will stop listing for
- # the response, but whether the worker stops processing depends on the
- # worker. For example, if the worker is stuck, it may not react to cancelled
- # requests.
- #
- # The default and maximum values depend on the type of request:
- #
- # * For HTTP tasks, the default is 10 minutes. The deadline
- # must be in the interval [15 seconds, 30 minutes].
- #
- # * For App Engine tasks, 0 indicates that the
- # request has the default deadline. The default deadline depends on the
- # [scaling
- # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
- # of the service: 10 minutes for standard apps with automatic scaling, 24
- # hours for standard apps with manual and basic scaling, and 60 minutes for
- # flex apps. If the request deadline is set, it must be in the interval [15
- # seconds, 24 hours 15 seconds]. Regardless of the task's
- # `dispatch_deadline`, the app handler will not run for longer than than
- # the service's timeout. We recommend setting the `dispatch_deadline` to
- # at most a few seconds more than the app handler's timeout. For more
- # information see
- # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
- #
- # `dispatch_deadline` will be truncated to the nearest millisecond. The
- # deadline is an approximate deadline.
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
- "createTime": "A String", # Output only. The time that the task was created.
- #
- # `create_time` will be truncated to the nearest second.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
- "responseCount": 42, # Output only. The number of attempts which have received a response.
},
],
+ "nextPageToken": "A String", # A token to retrieve next page of results.
+ #
+ # To return the next page of results, call
+ # ListTasks with this value as the
+ # page_token.
+ #
+ # If the next_page_token is empty, there are no more results.
}</pre>
</div>
@@ -2112,7 +2112,7 @@
previous_response: The response from the request for the previous page. (required)
Returns:
- A request object that you can call 'execute()' on to request the next
+ A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
@@ -2134,11 +2134,11 @@
contains the status after the task is dispatched but
before the task is received by its target.
-If Cloud Tasks receives a successful response from the task's
-target, then the task will be deleted; otherwise the task's
+If Cloud Tasks receives a successful response from the task's
+target, then the task will be deleted; otherwise the task's
schedule_time will be reset to the time that
RunTask was called plus the retry delay specified
-in the queue's RetryConfig.
+in the queue's RetryConfig.
RunTask returns
NOT_FOUND when it is called on a
@@ -2152,7 +2152,7 @@
{ # Request message for forcing a task to run now using
# RunTask.
- "responseView": "A String", # The response_view specifies which subset of the Task will be
+ "responseView": "A String", # The response_view specifies which subset of the Task will be
# returned.
#
# By default response_view is BASIC; not all
@@ -2175,123 +2175,110 @@
An object of the form:
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+ # respond by this deadline then the request is cancelled and the attempt
+ # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+ # task according to the RetryConfig.
#
- # An HTTP task is a task that has HttpRequest set.
+ # Note that when the request is cancelled, Cloud Tasks will stop listing for
+ # the response, but whether the worker stops processing depends on the
+ # worker. For example, if the worker is stuck, it may not react to cancelled
+ # requests.
#
- # The task will be pushed to the worker as an HTTP request. If the worker
- # or the redirected worker acknowledges the task by returning a successful HTTP
- # response code ([`200` - `299`]), the task will be removed from the queue. If
- # any other HTTP response code is returned or no response is received, the
- # task will be retried according to the following:
+ # The default and maximum values depend on the type of request:
#
- # * User-specified throttling: retry configuration,
- # rate limits, and the queue's state.
+ # * For HTTP tasks, the default is 10 minutes. The deadline
+ # must be in the interval [15 seconds, 30 minutes].
#
- # * System throttling: To prevent the worker from overloading, Cloud Tasks may
- # temporarily reduce the queue's effective rate. User-specified settings
- # will not be changed.
+ # * For App Engine tasks, 0 indicates that the
+ # request has the default deadline. The default deadline depends on the
+ # [scaling
+ # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
+ # of the service: 10 minutes for standard apps with automatic scaling, 24
+ # hours for standard apps with manual and basic scaling, and 60 minutes for
+ # flex apps. If the request deadline is set, it must be in the interval [15
+ # seconds, 24 hours 15 seconds]. Regardless of the task's
+ # `dispatch_deadline`, the app handler will not run for longer than than
+ # the service's timeout. We recommend setting the `dispatch_deadline` to
+ # at most a few seconds more than the app handler's timeout. For more
+ # information see
+ # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
#
- # System throttling happens because:
+ # `dispatch_deadline` will be truncated to the nearest millisecond. The
+ # deadline is an approximate deadline.
+ "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
- # * Cloud Tasks backs off on all errors. Normally the backoff specified in
- # rate limits will be used. But if the worker returns
- # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
- # errors is high, Cloud Tasks will use a higher backoff rate. The retry
- # specified in the `Retry-After` HTTP response header is considered.
- #
- # * To prevent traffic spikes and to smooth sudden increases in traffic,
- # dispatches ramp up slowly when the queue is newly created or idle and
- # if large numbers of tasks suddenly become available to dispatch (due to
- # spikes in create task rates, the queue being unpaused, or many tasks
- # that are scheduled at the same time).
- "body": "A String", # HTTP request body.
+ # Only dispatch_time will be set.
+ # The other Attempt information is not retained by Cloud Tasks.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
#
- # A request body is allowed only if the
- # HTTP method is POST, PUT, or PATCH. It is an
- # error to set body on a task with an incompatible HttpMethod.
- "headers": { # HTTP request headers.
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
#
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
#
- # These headers represent a subset of the headers that will accompany the
- # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
#
- # A partial list of headers that will be ignored or replaced is:
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
#
- # * Host: This will be computed by Cloud Tasks and derived from
- # HttpRequest.url.
- # * Content-Length: This will be computed by Cloud Tasks.
- # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
- # * X-Google-*: Google use only.
- # * X-AppEngine-*: Google use only.
- #
- # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
- # `Content-Type` to a media type when the
- # task is created.
- # For example, `Content-Type` can be set to `"application/octet-stream"` or
- # `"application/json"`.
- #
- # Headers which can have multiple values (according to RFC2616) can be
- # specified using comma-separated values.
- #
- # The size of the headers must be less than 80KB.
- "a_key": "A String",
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
- "url": "A String", # Required. The full url path that the request will be sent to.
- #
- # This string must begin with either "http://" or "https://". Some examples
- # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
- # encode some characters for safety and compatibility. The maximum allowed
- # URL length is 2083 characters after encoding.
- #
- # The `Location` header response from a redirect response [`300` - `399`]
- # may be followed. The redirect is not counted as a separate attempt.
- "oidcToken": { # Contains information needed for generating an # If specified, an
- # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
- # token will be generated and attached as an `Authorization` header in the
- # HTTP request.
- #
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- # [OpenID Connect
- # token](https://developers.google.com/identity/protocols/OpenIDConnect).
- # This type of authorization can be used for many scenarios, including
- # calling Cloud Run, or endpoints where you intend to validate the token
- # yourself.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OIDC token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "oauthToken": { # Contains information needed for generating an # If specified, an
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
- # will be generated and attached as an `Authorization` header in the HTTP
- # request.
- #
- # This type of authorization should generally only be used when calling
- # Google APIs hosted on *.googleapis.com.
- # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
- # This type of authorization should generally only be used when calling Google
- # APIs hosted on *.googleapis.com.
- "scope": "A String", # OAuth scope to be used for generating OAuth access token.
- # If not specified, "https://www.googleapis.com/auth/cloud-platform"
- # will be used.
- "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
- # to be used for generating OAuth token.
- # The service account must be within the same project as the queue. The
- # caller must have iam.serviceAccounts.actAs permission for the service
- # account.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
},
- "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+ "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ #
+ # `dispatch_time` will be truncated to the nearest microsecond.
+ "responseTime": "A String", # Output only. The time that this attempt response was received.
+ #
+ # `response_time` will be truncated to the nearest microsecond.
+ "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ #
+ # If `response_time` is unset, then the task has not been attempted or is
+ # currently running and the `response_status` field is meaningless.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ },
+ },
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
+ "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
#
# An App Engine task is a task that has AppEngineHttpRequest set.
#
@@ -2343,112 +2330,18 @@
# required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
# Task dispatches also do not follow redirects.
#
- # The task attempt has succeeded if the app's request handler returns an HTTP
+ # The task attempt has succeeded if the app's request handler returns an HTTP
# response code in the range [`200` - `299`]. The task attempt has failed if
- # the app's handler returns a non-2xx response code or Cloud Tasks does
+ # the app's handler returns a non-2xx response code or Cloud Tasks does
# not receive response before the deadline. Failed
# tasks will be retried according to the
# retry configuration. `503` (Service Unavailable) is
# considered an App Engine system error instead of an application error and
- # will cause Cloud Tasks' traffic congestion control to temporarily throttle
- # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+ # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+ # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
# Requests) response from an app handler does not cause traffic congestion
# control to throttle the queue.
- "body": "A String", # HTTP request body.
- #
- # A request body is allowed only if the HTTP method is POST or PUT. It is
- # an error to set a body on a task with an incompatible HttpMethod.
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- #
- # The app's request handler for the task's target URL must be able to handle
- # HTTP requests with this http_method, otherwise the task attempt fails with
- # error code 405 (Method Not Allowed). See [Writing a push task request
- # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
- # and the App Engine documentation for your runtime on [How Requests are
- # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # If set,
- # app_engine_routing_override
- # is used for all tasks in the queue, no matter what the setting is for the
- # task-level app_engine_routing.
- #
- # Defines routing characteristics specific to App Engine - service, version,
- # and instance.
- #
- # For more information about services, versions, and instances see
- # [An Overview of App
- # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
- # [Microservices Architecture on Google App
- # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
- # [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).
- "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).
- "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).
- "version": "A String", # App version.
- #
- # By default, the task is sent to the version which is the default
- # version when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- "service": "A String", # App service.
- #
- # By default, the task is sent to the service which is the default
- # service when the task is attempted.
- #
- # For some queues or tasks which were created using the App Engine
- # Task Queue API, host is not parsable
- # into service,
- # version, and
- # instance. For example, some tasks
- # which were created using the App Engine SDK use a custom domain
- # name; custom domains are not parsed by Cloud Tasks. If
- # host is not parsable, then
- # service,
- # version, and
- # instance are the empty string.
- },
- "relativeUri": "A String", # The relative URI.
- #
- # The relative URI must begin with "/" and must be a valid HTTP relative URI.
- # It can contain a path and query string arguments.
- # If the relative URI is empty, then the root path "/" will be used.
- # No spaces are allowed, and the maximum length allowed is 2083 characters.
- "headers": { # HTTP request headers.
+ "headers": { # HTTP request headers.
#
# This map contains the header field names and values.
# Headers can be set when the
@@ -2458,19 +2351,19 @@
# Cloud Tasks sets some headers to default values:
#
# * `User-Agent`: By default, this header is
- # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
# This header can be modified, but Cloud Tasks will append
- # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+ # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
# modified `User-Agent`.
#
# If the task has a body, Cloud
# Tasks sets the following headers:
#
# * `Content-Type`: By default, the `Content-Type` header is set to
- # `"application/octet-stream"`. The default can be overridden by explicitly
+ # `"application/octet-stream"`. The default can be overridden by explicitly
# setting `Content-Type` to a particular media type when the
# task is created.
- # For example, `Content-Type` can be set to `"application/json"`.
+ # For example, `Content-Type` can be set to `"application/json"`.
# * `Content-Length`: This is computed by Cloud Tasks. This value is
# output only. It cannot be changed.
#
@@ -2490,77 +2383,230 @@
# Although there is no specific limit for the maximum number of headers or
# the size, there is a limit on the maximum size of the Task. For more
# information, see the CreateTask documentation.
- "a_key": "A String",
+ "a_key": "A String",
},
+ "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+ #
+ # If set,
+ # app_engine_routing_override
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level app_engine_routing.
+ #
+ # Defines routing characteristics specific to App Engine - service, version,
+ # and instance.
+ #
+ # For more information about services, versions, and instances see
+ # [An Overview of App
+ # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+ # [Microservices Architecture on Google App
+ # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+ # [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
+ # version when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ "service": "A String", # App service.
+ #
+ # By default, the task is sent to the service which is the default
+ # service when the task is attempted.
+ #
+ # For some queues or tasks which were created using the App Engine
+ # Task Queue API, host is not parsable
+ # into service,
+ # version, and
+ # instance. For example, some tasks
+ # which were created using the App Engine SDK use a custom domain
+ # name; custom domains are not parsed by Cloud Tasks. If
+ # host is not parsable, then
+ # 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).
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ #
+ # The app's request handler for the task's target URL must be able to handle
+ # HTTP requests with this http_method, otherwise the task attempt fails with
+ # error code 405 (Method Not Allowed). See [Writing a push task request
+ # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+ # and the App Engine documentation for your runtime on [How Requests are
+ # Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled).
+ "body": "A String", # HTTP request body.
+ #
+ # A request body is allowed only if the HTTP method is POST or PUT. It is
+ # an error to set a body on a task with an incompatible HttpMethod.
+ "relativeUri": "A String", # The relative URI.
+ #
+ # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+ # It can contain a path and query string arguments.
+ # If the relative URI is empty, then the root path "/" will be used.
+ # No spaces are allowed, and the maximum length allowed is 2083 characters.
},
- "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "createTime": "A String", # Output only. The time that the task was created.
#
- # Only dispatch_time will be set.
- # The other Attempt information is not retained by Cloud Tasks.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+ # `create_time` will be truncated to the nearest second.
+ "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+ #
+ # For App Engine queues, this is when the task will be attempted or retried.
+ #
+ # `schedule_time` will be truncated to the nearest microsecond.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the task's target.
+ #
+ # An HTTP task is a task that has HttpRequest set.
+ #
+ # The task will be pushed to the worker as an HTTP request. If the worker
+ # or the redirected worker acknowledges the task by returning a successful HTTP
+ # response code ([`200` - `299`]), the task will be removed from the queue. If
+ # any other HTTP response code is returned or no response is received, the
+ # task will be retried according to the following:
+ #
+ # * User-specified throttling: retry configuration,
+ # rate limits, and the queue's state.
+ #
+ # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+ # temporarily reduce the queue's effective rate. User-specified settings
+ # will not be changed.
+ #
+ # System throttling happens because:
+ #
+ # * Cloud Tasks backs off on all errors. Normally the backoff specified in
+ # rate limits will be used. But if the worker returns
+ # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+ # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+ # specified in the `Retry-After` HTTP response header is considered.
+ #
+ # * To prevent traffic spikes and to smooth sudden increases in traffic,
+ # dispatches ramp up slowly when the queue is newly created or idle and
+ # if large numbers of tasks suddenly become available to dispatch (due to
+ # spikes in create task rates, the queue being unpaused, or many tasks
+ # that are scheduled at the same time).
+ "url": "A String", # Required. The full url path that the request will be sent to.
#
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+ # This string must begin with either "http://" or "https://". Some examples
+ # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+ # encode some characters for safety and compatibility. The maximum allowed
+ # URL length is 2083 characters after encoding.
#
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
+ # The `Location` header response from a redirect response [`300` - `399`]
+ # may be followed. The redirect is not counted as a separate attempt.
+ "oidcToken": { # Contains information needed for generating an # If specified, an
+ # [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+ # token will be generated and attached as an `Authorization` header in the
+ # HTTP request.
#
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ # [OpenID Connect
+ # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+ # This type of authorization can be used for many scenarios, including
+ # calling Cloud Run, or endpoints where you intend to validate the token
+ # yourself.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OIDC token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "body": "A String", # HTTP request body.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # A request body is allowed only if the
+ # HTTP method is POST, PUT, or PATCH. It is an
+ # error to set body on a task with an incompatible HttpMethod.
+ "oauthToken": { # Contains information needed for generating an # If specified, an
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+ # will be generated and attached as an `Authorization` header in the HTTP
+ # request.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
- },
- "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
- "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
- #
- # If `response_time` is unset, then the task has not been attempted or is
- # currently running and the `response_status` field is meaningless.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ # This type of authorization should generally only be used when calling
+ # Google APIs hosted on *.googleapis.com.
+ # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+ # This type of authorization should generally only be used when calling Google
+ # APIs hosted on *.googleapis.com.
+ "scope": "A String", # OAuth scope to be used for generating OAuth access token.
+ # If not specified, "https://www.googleapis.com/auth/cloud-platform"
+ # will be used.
+ "serviceAccountEmail": "A String", # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+ # to be used for generating OAuth token.
+ # The service account must be within the same project as the queue. The
+ # caller must have iam.serviceAccounts.actAs permission for the service
+ # account.
},
- "responseTime": "A String", # Output only. The time that this attempt response was received.
+ "headers": { # HTTP request headers.
#
- # `response_time` will be truncated to the nearest microsecond.
- "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
#
- # `dispatch_time` will be truncated to the nearest microsecond.
+ # These headers represent a subset of the headers that will accompany the
+ # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+ #
+ # A partial list of headers that will be ignored or replaced is:
+ #
+ # * Host: This will be computed by Cloud Tasks and derived from
+ # HttpRequest.url.
+ # * Content-Length: This will be computed by Cloud Tasks.
+ # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+ # * X-Google-*: Google use only.
+ # * X-AppEngine-*: Google use only.
+ #
+ # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+ # `Content-Type` to a media type when the
+ # task is created.
+ # For example, `Content-Type` can be set to `"application/octet-stream"` or
+ # `"application/json"`.
+ #
+ # Headers which can have multiple values (according to RFC2616) can be
+ # specified using comma-separated values.
+ #
+ # The size of the headers must be less than 80KB.
+ "a_key": "A String",
+ },
},
- "name": "A String", # Optionally caller-specified in CreateTask.
+ "name": "A String", # Optionally caller-specified in CreateTask.
#
# The task name.
#
@@ -2572,7 +2618,7 @@
# 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 task's location.
+ # * `LOCATION_ID` is the canonical ID for the task's location.
# The list of available locations can be obtained by calling
# ListLocations.
# For more information, see https://cloud.google.com/about/locations/.
@@ -2580,52 +2626,6 @@
# hyphens (-). The maximum length is 100 characters.
# * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
# hyphens (-), or underscores (_). The maximum length is 500 characters.
- "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
- #
- # For App Engine queues, this is when the task will be attempted or retried.
- #
- # `schedule_time` will be truncated to the nearest microsecond.
- "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
- # respond by this deadline then the request is cancelled and the attempt
- # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
- # task according to the RetryConfig.
- #
- # Note that when the request is cancelled, Cloud Tasks will stop listing for
- # the response, but whether the worker stops processing depends on the
- # worker. For example, if the worker is stuck, it may not react to cancelled
- # requests.
- #
- # The default and maximum values depend on the type of request:
- #
- # * For HTTP tasks, the default is 10 minutes. The deadline
- # must be in the interval [15 seconds, 30 minutes].
- #
- # * For App Engine tasks, 0 indicates that the
- # request has the default deadline. The default deadline depends on the
- # [scaling
- # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
- # of the service: 10 minutes for standard apps with automatic scaling, 24
- # hours for standard apps with manual and basic scaling, and 60 minutes for
- # flex apps. If the request deadline is set, it must be in the interval [15
- # seconds, 24 hours 15 seconds]. Regardless of the task's
- # `dispatch_deadline`, the app handler will not run for longer than than
- # the service's timeout. We recommend setting the `dispatch_deadline` to
- # at most a few seconds more than the app handler's timeout. For more
- # information see
- # [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
- #
- # `dispatch_deadline` will be truncated to the nearest millisecond. The
- # deadline is an approximate deadline.
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
- "createTime": "A String", # Output only. The time that the task was created.
- #
- # `create_time` will be truncated to the nearest second.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
- "responseCount": 42, # Output only. The number of attempts which have received a response.
}</pre>
</div>