Task(mapping=None, *, ignore_unknown_fields=False, **kwargs)
A unit of scheduled work. .. attribute:: name
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, seeIdentifying 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.:type: str
Attributes
Name | Description |
app_engine_http_request |
google.cloud.tasks_v2.types.AppEngineHttpRequest
HTTP request that is sent to the App Engine app handler. An App Engine task is a task that has AppEngineHttpRequest set. |
http_request |
google.cloud.tasks_v2.types.HttpRequest
HTTP request that is sent to the worker. An HTTP task is a task that has HttpRequest set. |
schedule_time |
google.protobuf.timestamp_pb2.Timestamp
The time when the task is scheduled to be attempted or retried. schedule_time will be truncated to the nearest
microsecond.
|
create_time |
google.protobuf.timestamp_pb2.Timestamp
Output only. The time that the task was created. create_time will be truncated to the nearest second.
|
dispatch_deadline |
google.protobuf.duration_pb2.Duration
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][google.cloud.tasks.v2.AppEngineHttpRequest], 0
indicates that the request has the default deadline. The
default deadline depends on the `scaling
type |
dispatch_count |
int
Output only. The number of attempts dispatched. This count includes attempts which have been dispatched but haven't received a response. |
response_count |
int
Output only. The number of attempts which have received a response. |
first_attempt |
google.cloud.tasks_v2.types.Attempt
Output only. The status of the task's first attempt. Only dispatch_time will be set. The other Attempt information is not retained by Cloud Tasks. |
last_attempt |
google.cloud.tasks_v2.types.Attempt
Output only. The status of the task's last attempt. |
view |
google.cloud.tasks_v2.types.Task.View
Output only. The view specifies which subset of the Task has been returned. |
Classes
View
View(value)
The view specifies a subset of Task data.
When a task is returned in a response, not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed because of its large size or because of the sensitivity of data that it contains.