docs: update generated docs (#981)
diff --git a/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html b/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html
index 23a392b..1759b3c 100644
--- a/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html
+++ b/docs/dyn/cloudtasks_v2.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, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, pageSize=None, responseView=None, pageToken=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>
@@ -155,177 +155,6 @@
# 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 worker.
- #
- # 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).
- "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.
- },
- "headers": { # HTTP request headers.
- #
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
- #
- # 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",
- },
- "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.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- "body": "A String", # HTTP request body.
- #
- # 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.
- },
- "name": "A String", # Optionally caller-specified in CreateTask.
- #
- # The task name.
- #
- # The task name must have the following format:
- # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
- #
- # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), colons (:), or periods (.).
- # For more information, see
- # [Identifying
- # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the task's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
- # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), or underscores (_). The maximum length is 500 characters.
- "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.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
"firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
# Only dispatch_time will be set.
@@ -333,6 +162,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -343,20 +175,17 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
@@ -365,6 +194,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -375,25 +207,21 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
},
- "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.
@@ -425,8 +253,9 @@
# delivered to can be set at the queue-level or task-level:
#
# * If app_engine_routing_override is set on the
- # queue, this value is used for all
- # tasks in the queue, no matter what the setting is for the task-level
+ # queue, this value
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level
# app_engine_routing.
#
#
@@ -456,6 +285,102 @@
# 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 app_engine_routing_override is set on the
+ # queue, this
+ # value 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).
+ #
+ # Using AppEngineRouting requires
+ # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
+ # Google IAM permission for the project
+ # and the following scope:
+ #
+ # `https://www.googleapis.com/auth/cloud-platform`
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "version": "A String", # App version.
+ #
+ # By default, the task is sent to the version which is the default
+ # 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.
+ "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).
+ },
"headers": { # HTTP request headers.
#
# This map contains the header field names and values.
@@ -500,101 +425,6 @@
# information, see the CreateTask documentation.
"a_key": "A String",
},
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # * If app_engine_routing_override is set on the
- # queue, this value 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).
- #
- # Using AppEngineRouting requires
- # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
- # Google IAM permission for the project
- # and the following scope:
- #
- # `https://www.googleapis.com/auth/cloud-platform`
- "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).
- "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).
- },
- "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.
@@ -602,14 +432,186 @@
# 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.
},
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
"scheduleTime": "A String", # The time when the task is scheduled to be attempted or retried.
#
# `schedule_time` will be truncated to the nearest microsecond.
+ "name": "A String", # Optionally caller-specified in CreateTask.
+ #
+ # The task name.
+ #
+ # The task name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+ #
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the task's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), or underscores (_). The maximum length is 500 characters.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
"createTime": "A String", # Output only. The time that the task was created.
#
# `create_time` will be truncated to the nearest second.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
+ #
+ # 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).
+ "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.
+ "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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ },
+ "headers": { # HTTP request headers.
+ #
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
+ #
+ # 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",
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "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.
+ },
+ "body": "A String", # HTTP request body.
+ #
+ # 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.
+ "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.
+ },
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "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 listening
+ # 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.
},
}
@@ -622,177 +624,6 @@
An object of the form:
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
- #
- # 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).
- "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.
- },
- "headers": { # HTTP request headers.
- #
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
- #
- # 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",
- },
- "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.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- "body": "A String", # HTTP request body.
- #
- # 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.
- },
- "name": "A String", # Optionally caller-specified in CreateTask.
- #
- # The task name.
- #
- # The task name must have the following format:
- # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
- #
- # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), colons (:), or periods (.).
- # For more information, see
- # [Identifying
- # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the task's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
- # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), or underscores (_). The maximum length is 500 characters.
- "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.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
"firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
# Only dispatch_time will be set.
@@ -800,6 +631,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -810,20 +644,17 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
@@ -832,6 +663,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -842,25 +676,21 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
},
- "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.
@@ -892,8 +722,9 @@
# delivered to can be set at the queue-level or task-level:
#
# * If app_engine_routing_override is set on the
- # queue, this value is used for all
- # tasks in the queue, no matter what the setting is for the task-level
+ # queue, this value
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level
# app_engine_routing.
#
#
@@ -923,6 +754,102 @@
# 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 app_engine_routing_override is set on the
+ # queue, this
+ # value 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).
+ #
+ # Using AppEngineRouting requires
+ # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
+ # Google IAM permission for the project
+ # and the following scope:
+ #
+ # `https://www.googleapis.com/auth/cloud-platform`
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "version": "A String", # App version.
+ #
+ # By default, the task is sent to the version which is the default
+ # 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.
+ "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).
+ },
"headers": { # HTTP request headers.
#
# This map contains the header field names and values.
@@ -967,101 +894,6 @@
# information, see the CreateTask documentation.
"a_key": "A String",
},
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # * If app_engine_routing_override is set on the
- # queue, this value 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).
- #
- # Using AppEngineRouting requires
- # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
- # Google IAM permission for the project
- # and the following scope:
- #
- # `https://www.googleapis.com/auth/cloud-platform`
- "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).
- "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).
- },
- "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.
@@ -1069,14 +901,186 @@
# 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.
},
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
"scheduleTime": "A String", # The time when the task is scheduled to be attempted or retried.
#
# `schedule_time` will be truncated to the nearest microsecond.
+ "name": "A String", # Optionally caller-specified in CreateTask.
+ #
+ # The task name.
+ #
+ # The task name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+ #
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the task's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), or underscores (_). The maximum length is 500 characters.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
"createTime": "A String", # Output only. The time that the task was created.
#
# `create_time` will be truncated to the nearest second.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
+ #
+ # 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).
+ "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.
+ "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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ },
+ "headers": { # HTTP request headers.
+ #
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
+ #
+ # 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",
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "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.
+ },
+ "body": "A String", # HTTP request body.
+ #
+ # 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.
+ "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.
+ },
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "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 listening
+ # 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.
}</pre>
</div>
@@ -1139,177 +1143,6 @@
An object of the form:
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
- #
- # 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).
- "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.
- },
- "headers": { # HTTP request headers.
- #
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
- #
- # 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",
- },
- "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.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- "body": "A String", # HTTP request body.
- #
- # 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.
- },
- "name": "A String", # Optionally caller-specified in CreateTask.
- #
- # The task name.
- #
- # The task name must have the following format:
- # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
- #
- # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), colons (:), or periods (.).
- # For more information, see
- # [Identifying
- # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the task's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
- # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), or underscores (_). The maximum length is 500 characters.
- "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.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
"firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
# Only dispatch_time will be set.
@@ -1317,6 +1150,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -1327,20 +1163,17 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
@@ -1349,6 +1182,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -1359,25 +1195,21 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
},
- "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.
@@ -1409,8 +1241,9 @@
# delivered to can be set at the queue-level or task-level:
#
# * If app_engine_routing_override is set on the
- # queue, this value is used for all
- # tasks in the queue, no matter what the setting is for the task-level
+ # queue, this value
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level
# app_engine_routing.
#
#
@@ -1440,6 +1273,102 @@
# 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 app_engine_routing_override is set on the
+ # queue, this
+ # value 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).
+ #
+ # Using AppEngineRouting requires
+ # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
+ # Google IAM permission for the project
+ # and the following scope:
+ #
+ # `https://www.googleapis.com/auth/cloud-platform`
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "version": "A String", # App version.
+ #
+ # By default, the task is sent to the version which is the default
+ # 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.
+ "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).
+ },
"headers": { # HTTP request headers.
#
# This map contains the header field names and values.
@@ -1484,101 +1413,6 @@
# information, see the CreateTask documentation.
"a_key": "A String",
},
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # * If app_engine_routing_override is set on the
- # queue, this value 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).
- #
- # Using AppEngineRouting requires
- # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
- # Google IAM permission for the project
- # and the following scope:
- #
- # `https://www.googleapis.com/auth/cloud-platform`
- "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).
- "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).
- },
- "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.
@@ -1586,19 +1420,191 @@
# 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.
},
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
"scheduleTime": "A String", # The time when the task is scheduled to be attempted or retried.
#
# `schedule_time` will be truncated to the nearest microsecond.
+ "name": "A String", # Optionally caller-specified in CreateTask.
+ #
+ # The task name.
+ #
+ # The task name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+ #
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the task's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), or underscores (_). The maximum length is 500 characters.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
"createTime": "A String", # Output only. The time that the task was created.
#
# `create_time` will be truncated to the nearest second.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
+ #
+ # 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).
+ "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.
+ "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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ },
+ "headers": { # HTTP request headers.
+ #
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
+ #
+ # 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",
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "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.
+ },
+ "body": "A String", # HTTP request body.
+ #
+ # 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.
+ "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.
+ },
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "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 listening
+ # 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.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, responseView=None, pageToken=None, pageSize=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, pageSize=None, responseView=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists the tasks in a queue.
By default, only the BASIC view is retrieved
@@ -1612,6 +1618,14 @@
Args:
parent: string, Required. The queue name. For example:
`projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` (required)
+ 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.
responseView: string, The response_view specifies which subset of the Task will be
returned.
@@ -1633,14 +1647,6 @@
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
@@ -1650,179 +1656,15 @@
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.
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
- #
- # 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).
- "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.
- },
- "headers": { # HTTP request headers.
- #
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
- #
- # 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",
- },
- "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.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- "body": "A String", # HTTP request body.
- #
- # 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.
- },
- "name": "A String", # Optionally caller-specified in CreateTask.
- #
- # The task name.
- #
- # The task name must have the following format:
- # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
- #
- # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), colons (:), or periods (.).
- # For more information, see
- # [Identifying
- # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the task's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
- # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), or underscores (_). The maximum length is 500 characters.
- "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.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
"firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
# Only dispatch_time will be set.
@@ -1830,6 +1672,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -1840,20 +1685,17 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
@@ -1862,6 +1704,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -1872,25 +1717,21 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
},
- "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.
@@ -1922,8 +1763,9 @@
# delivered to can be set at the queue-level or task-level:
#
# * If app_engine_routing_override is set on the
- # queue, this value is used for all
- # tasks in the queue, no matter what the setting is for the task-level
+ # queue, this value
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level
# app_engine_routing.
#
#
@@ -1953,6 +1795,102 @@
# 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 app_engine_routing_override is set on the
+ # queue, this
+ # value 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).
+ #
+ # Using AppEngineRouting requires
+ # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
+ # Google IAM permission for the project
+ # and the following scope:
+ #
+ # `https://www.googleapis.com/auth/cloud-platform`
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "version": "A String", # App version.
+ #
+ # By default, the task is sent to the version which is the default
+ # 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.
+ "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).
+ },
"headers": { # HTTP request headers.
#
# This map contains the header field names and values.
@@ -1997,101 +1935,6 @@
# information, see the CreateTask documentation.
"a_key": "A String",
},
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # * If app_engine_routing_override is set on the
- # queue, this value 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).
- #
- # Using AppEngineRouting requires
- # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
- # Google IAM permission for the project
- # and the following scope:
- #
- # `https://www.googleapis.com/auth/cloud-platform`
- "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).
- "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).
- },
- "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.
@@ -2099,23 +1942,188 @@
# 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.
},
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
"scheduleTime": "A String", # The time when the task is scheduled to be attempted or retried.
#
# `schedule_time` will be truncated to the nearest microsecond.
+ "name": "A String", # Optionally caller-specified in CreateTask.
+ #
+ # The task name.
+ #
+ # The task name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+ #
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the task's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), or underscores (_). The maximum length is 500 characters.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
"createTime": "A String", # Output only. The time that the task was created.
#
# `create_time` will be truncated to the nearest second.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
+ #
+ # 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).
+ "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.
+ "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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ },
+ "headers": { # HTTP request headers.
+ #
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
+ #
+ # 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",
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "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.
+ },
+ "body": "A String", # HTTP request body.
+ #
+ # 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.
+ "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.
+ },
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "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 listening
+ # 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.
},
],
- "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>
@@ -2191,177 +2199,6 @@
An object of the form:
{ # A unit of scheduled work.
- "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
- #
- # 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).
- "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.
- },
- "headers": { # HTTP request headers.
- #
- # This map contains the header field names and values.
- # Headers can be set when the
- # task is created.
- #
- # 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",
- },
- "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.
- },
- "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
- "body": "A String", # HTTP request body.
- #
- # 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.
- },
- "name": "A String", # Optionally caller-specified in CreateTask.
- #
- # The task name.
- #
- # The task name must have the following format:
- # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
- #
- # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), colons (:), or periods (.).
- # For more information, see
- # [Identifying
- # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
- # * `LOCATION_ID` is the canonical ID for the task's location.
- # The list of available locations can be obtained by calling
- # ListLocations.
- # For more information, see https://cloud.google.com/about/locations/.
- # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
- # hyphens (-). The maximum length is 100 characters.
- # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
- # hyphens (-), or underscores (_). The maximum length is 500 characters.
- "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.
- "dispatchCount": 42, # Output only. The number of attempts dispatched.
- #
- # This count includes attempts which have been dispatched but haven't
- # received a response.
"firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
#
# Only dispatch_time will be set.
@@ -2369,6 +2206,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -2379,20 +2219,17 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
@@ -2401,6 +2238,9 @@
"responseTime": "A String", # Output only. The time that this attempt response was received.
#
# `response_time` will be truncated to the nearest microsecond.
+ "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
@@ -2411,25 +2251,21 @@
#
# 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).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
- "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.
},
- "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.
},
- "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.
@@ -2461,8 +2297,9 @@
# delivered to can be set at the queue-level or task-level:
#
# * If app_engine_routing_override is set on the
- # queue, this value is used for all
- # tasks in the queue, no matter what the setting is for the task-level
+ # queue, this value
+ # is used for all tasks in the queue, no matter what the setting is for the
+ # task-level
# app_engine_routing.
#
#
@@ -2492,6 +2329,102 @@
# 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 app_engine_routing_override is set on the
+ # queue, this
+ # value 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).
+ #
+ # Using AppEngineRouting requires
+ # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
+ # Google IAM permission for the project
+ # and the following scope:
+ #
+ # `https://www.googleapis.com/auth/cloud-platform`
+ "instance": "A String", # App instance.
+ #
+ # By default, the task is sent to an instance which is available when
+ # the task is attempted.
+ #
+ # Requests can only be sent to a specific instance if
+ # [manual scaling is used in App Engine
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+ # App Engine Flex does not support instances. For more information, see
+ # [App Engine Standard request
+ # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+ # and [App Engine Flex request
+ # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+ "version": "A String", # App version.
+ #
+ # By default, the task is sent to the version which is the default
+ # 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.
+ "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).
+ },
"headers": { # HTTP request headers.
#
# This map contains the header field names and values.
@@ -2536,101 +2469,6 @@
# information, see the CreateTask documentation.
"a_key": "A String",
},
- "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
- #
- # * If app_engine_routing_override is set on the
- # queue, this value 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).
- #
- # Using AppEngineRouting requires
- # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
- # Google IAM permission for the project
- # and the following scope:
- #
- # `https://www.googleapis.com/auth/cloud-platform`
- "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).
- "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).
- },
- "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.
@@ -2638,14 +2476,186 @@
# 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.
},
- "view": "A String", # Output only. The view specifies which subset of the Task has
- # been returned.
"scheduleTime": "A String", # The time when the task is scheduled to be attempted or retried.
#
# `schedule_time` will be truncated to the nearest microsecond.
+ "name": "A String", # Optionally caller-specified in CreateTask.
+ #
+ # The task name.
+ #
+ # The task name must have the following format:
+ # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+ #
+ # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), colons (:), or periods (.).
+ # For more information, see
+ # [Identifying
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+ # * `LOCATION_ID` is the canonical ID for the task's location.
+ # The list of available locations can be obtained by calling
+ # ListLocations.
+ # For more information, see https://cloud.google.com/about/locations/.
+ # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+ # hyphens (-). The maximum length is 100 characters.
+ # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+ # hyphens (-), or underscores (_). The maximum length is 500 characters.
+ "view": "A String", # Output only. The view specifies which subset of the Task has
+ # been returned.
+ "responseCount": 42, # Output only. The number of attempts which have received a response.
"createTime": "A String", # Output only. The time that the task was created.
#
# `create_time` will be truncated to the nearest second.
+ "httpRequest": { # HTTP request. # HTTP request that is sent to the worker.
+ #
+ # 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).
+ "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.
+ "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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ },
+ "headers": { # HTTP request headers.
+ #
+ # This map contains the header field names and values.
+ # Headers can be set when the
+ # task is created.
+ #
+ # 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",
+ },
+ "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+ "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.
+ },
+ "body": "A String", # HTTP request body.
+ #
+ # 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.
+ "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.
+ },
+ "dispatchCount": 42, # Output only. The number of attempts dispatched.
+ #
+ # This count includes attempts which have been dispatched but haven't
+ # received a response.
+ "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 listening
+ # 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.
}</pre>
</div>