public final class Task extends GeneratedMessageV3 implements TaskOrBuilder
A unit of scheduled work.
Protobuf type google.cloud.tasks.v2.Task
Static Fields
APP_ENGINE_HTTP_REQUEST_FIELD_NUMBER
public static final int APP_ENGINE_HTTP_REQUEST_FIELD_NUMBER
Field Value
CREATE_TIME_FIELD_NUMBER
public static final int CREATE_TIME_FIELD_NUMBER
Field Value
DISPATCH_COUNT_FIELD_NUMBER
public static final int DISPATCH_COUNT_FIELD_NUMBER
Field Value
DISPATCH_DEADLINE_FIELD_NUMBER
public static final int DISPATCH_DEADLINE_FIELD_NUMBER
Field Value
FIRST_ATTEMPT_FIELD_NUMBER
public static final int FIRST_ATTEMPT_FIELD_NUMBER
Field Value
HTTP_REQUEST_FIELD_NUMBER
public static final int HTTP_REQUEST_FIELD_NUMBER
Field Value
LAST_ATTEMPT_FIELD_NUMBER
public static final int LAST_ATTEMPT_FIELD_NUMBER
Field Value
NAME_FIELD_NUMBER
public static final int NAME_FIELD_NUMBER
Field Value
RESPONSE_COUNT_FIELD_NUMBER
public static final int RESPONSE_COUNT_FIELD_NUMBER
Field Value
SCHEDULE_TIME_FIELD_NUMBER
public static final int SCHEDULE_TIME_FIELD_NUMBER
Field Value
VIEW_FIELD_NUMBER
public static final int VIEW_FIELD_NUMBER
Field Value
Static Methods
getDefaultInstance()
public static Task getDefaultInstance()
Returns
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns
newBuilder()
public static Task.Builder newBuilder()
Returns
newBuilder(Task prototype)
public static Task.Builder newBuilder(Task prototype)
Parameter
| Name | Description |
| prototype | Task
|
Returns
public static Task parseDelimitedFrom(InputStream input)
Parameter
Returns
Exceptions
public static Task parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(byte[] data)
public static Task parseFrom(byte[] data)
Parameter
| Name | Description |
| data | byte[]
|
Returns
Exceptions
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static Task parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteString data)
public static Task parseFrom(ByteString data)
Parameter
Returns
Exceptions
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static Task parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Task parseFrom(CodedInputStream input)
Parameter
Returns
Exceptions
public static Task parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Task parseFrom(InputStream input)
Parameter
Returns
Exceptions
public static Task parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteBuffer data)
public static Task parseFrom(ByteBuffer data)
Parameter
Returns
Exceptions
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static Task parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parser()
public static Parser<Task> parser()
Returns
Methods
equals(Object obj)
public boolean equals(Object obj)
Parameter
Returns
Overrides
getAppEngineHttpRequest()
public AppEngineHttpRequest getAppEngineHttpRequest()
HTTP request that is sent to the App Engine app handler.
An App Engine task is a task that has AppEngineHttpRequest set.
.google.cloud.tasks.v2.AppEngineHttpRequest app_engine_http_request = 2;
getAppEngineHttpRequestOrBuilder()
public AppEngineHttpRequestOrBuilder getAppEngineHttpRequestOrBuilder()
HTTP request that is sent to the App Engine app handler.
An App Engine task is a task that has AppEngineHttpRequest set.
.google.cloud.tasks.v2.AppEngineHttpRequest app_engine_http_request = 2;
getCreateTime()
public Timestamp getCreateTime()
Output only. The time that the task was created.
create_time will be truncated to the nearest second.
.google.protobuf.Timestamp create_time = 5;
getCreateTimeOrBuilder()
public TimestampOrBuilder getCreateTimeOrBuilder()
Output only. The time that the task was created.
create_time will be truncated to the nearest second.
.google.protobuf.Timestamp create_time = 5;
getDefaultInstanceForType()
public Task getDefaultInstanceForType()
Returns
getDispatchCount()
public int getDispatchCount()
Output only. The number of attempts dispatched.
This count includes attempts which have been dispatched but haven't
received a response.
int32 dispatch_count = 7;
| Type | Description |
| int | The dispatchCount.
|
getDispatchDeadline()
public Duration getDispatchDeadline()
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
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.
dispatch_deadline will be truncated to the nearest millisecond. The
deadline is an approximate deadline.
.google.protobuf.Duration dispatch_deadline = 6;
| Type | Description |
| Duration | The dispatchDeadline.
|
getDispatchDeadlineOrBuilder()
public DurationOrBuilder getDispatchDeadlineOrBuilder()
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
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.
dispatch_deadline will be truncated to the nearest millisecond. The
deadline is an approximate deadline.
.google.protobuf.Duration dispatch_deadline = 6;
getFirstAttempt()
public Attempt getFirstAttempt()
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.
.google.cloud.tasks.v2.Attempt first_attempt = 9;
| Type | Description |
| Attempt | The firstAttempt.
|
getFirstAttemptOrBuilder()
public AttemptOrBuilder getFirstAttemptOrBuilder()
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.
.google.cloud.tasks.v2.Attempt first_attempt = 9;
getHttpRequest()
public HttpRequest getHttpRequest()
HTTP request that is sent to the worker.
An HTTP task is a task that has HttpRequest set.
.google.cloud.tasks.v2.HttpRequest http_request = 3;
getHttpRequestOrBuilder()
public HttpRequestOrBuilder getHttpRequestOrBuilder()
HTTP request that is sent to the worker.
An HTTP task is a task that has HttpRequest set.
.google.cloud.tasks.v2.HttpRequest http_request = 3;
getLastAttempt()
public Attempt getLastAttempt()
Output only. The status of the task's last attempt.
.google.cloud.tasks.v2.Attempt last_attempt = 10;
| Type | Description |
| Attempt | The lastAttempt.
|
getLastAttemptOrBuilder()
public AttemptOrBuilder getLastAttemptOrBuilder()
Output only. The status of the task's last attempt.
.google.cloud.tasks.v2.Attempt last_attempt = 10;
getMessageTypeCase()
public Task.MessageTypeCase getMessageTypeCase()
Returns
getName()
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
projectsLOCATION_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.
string name = 1;
| Type | Description |
| String | The name.
|
getNameBytes()
public ByteString getNameBytes()
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
projectsLOCATION_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.
string name = 1;
getParserForType()
public Parser<Task> getParserForType()
Returns
Overrides
getResponseCount()
public int getResponseCount()
Output only. The number of attempts which have received a response.
int32 response_count = 8;
| Type | Description |
| int | The responseCount.
|
getScheduleTime()
public Timestamp getScheduleTime()
The time when the task is scheduled to be attempted or retried.
schedule_time will be truncated to the nearest microsecond.
.google.protobuf.Timestamp schedule_time = 4;
getScheduleTimeOrBuilder()
public TimestampOrBuilder getScheduleTimeOrBuilder()
The time when the task is scheduled to be attempted or retried.
schedule_time will be truncated to the nearest microsecond.
.google.protobuf.Timestamp schedule_time = 4;
getSerializedSize()
public int getSerializedSize()
Returns
Overrides
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Returns
Overrides
getView()
public Task.View getView()
Output only. The view specifies which subset of the Task has
been returned.
.google.cloud.tasks.v2.Task.View view = 11;
getViewValue()
public int getViewValue()
Output only. The view specifies which subset of the Task has
been returned.
.google.cloud.tasks.v2.Task.View view = 11;
| Type | Description |
| int | The enum numeric value on the wire for view.
|
hasAppEngineHttpRequest()
public boolean hasAppEngineHttpRequest()
HTTP request that is sent to the App Engine app handler.
An App Engine task is a task that has AppEngineHttpRequest set.
.google.cloud.tasks.v2.AppEngineHttpRequest app_engine_http_request = 2;
| Type | Description |
| boolean | Whether the appEngineHttpRequest field is set.
|
hasCreateTime()
public boolean hasCreateTime()
Output only. The time that the task was created.
create_time will be truncated to the nearest second.
.google.protobuf.Timestamp create_time = 5;
| Type | Description |
| boolean | Whether the createTime field is set.
|
hasDispatchDeadline()
public boolean hasDispatchDeadline()
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
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.
dispatch_deadline will be truncated to the nearest millisecond. The
deadline is an approximate deadline.
.google.protobuf.Duration dispatch_deadline = 6;
| Type | Description |
| boolean | Whether the dispatchDeadline field is set.
|
hasFirstAttempt()
public boolean hasFirstAttempt()
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.
.google.cloud.tasks.v2.Attempt first_attempt = 9;
| Type | Description |
| boolean | Whether the firstAttempt field is set.
|
hasHttpRequest()
public boolean hasHttpRequest()
HTTP request that is sent to the worker.
An HTTP task is a task that has HttpRequest set.
.google.cloud.tasks.v2.HttpRequest http_request = 3;
| Type | Description |
| boolean | Whether the httpRequest field is set.
|
hasLastAttempt()
public boolean hasLastAttempt()
Output only. The status of the task's last attempt.
.google.cloud.tasks.v2.Attempt last_attempt = 10;
| Type | Description |
| boolean | Whether the lastAttempt field is set.
|
hasScheduleTime()
public boolean hasScheduleTime()
The time when the task is scheduled to be attempted or retried.
schedule_time will be truncated to the nearest microsecond.
.google.protobuf.Timestamp schedule_time = 4;
| Type | Description |
| boolean | Whether the scheduleTime field is set.
|
hashCode()
Returns
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
isInitialized()
public final boolean isInitialized()
Returns
Overrides
newBuilderForType()
public Task.Builder newBuilderForType()
Returns
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected Task.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Returns
Overrides
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Returns
Overrides
toBuilder()
public Task.Builder toBuilder()
Returns
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Parameter
Overrides
Exceptions
