Class Task (2.41.0)

public final class Task extends GeneratedMessageV3 implements TaskOrBuilder

A unit of scheduled work.

Protobuf type google.cloud.tasks.v2beta3.Task

Implements

TaskOrBuilder

Static Fields

APP_ENGINE_HTTP_REQUEST_FIELD_NUMBER

public static final int APP_ENGINE_HTTP_REQUEST_FIELD_NUMBER
Field Value
TypeDescription
int

CREATE_TIME_FIELD_NUMBER

public static final int CREATE_TIME_FIELD_NUMBER
Field Value
TypeDescription
int

DISPATCH_COUNT_FIELD_NUMBER

public static final int DISPATCH_COUNT_FIELD_NUMBER
Field Value
TypeDescription
int

DISPATCH_DEADLINE_FIELD_NUMBER

public static final int DISPATCH_DEADLINE_FIELD_NUMBER
Field Value
TypeDescription
int

FIRST_ATTEMPT_FIELD_NUMBER

public static final int FIRST_ATTEMPT_FIELD_NUMBER
Field Value
TypeDescription
int

HTTP_REQUEST_FIELD_NUMBER

public static final int HTTP_REQUEST_FIELD_NUMBER
Field Value
TypeDescription
int

LAST_ATTEMPT_FIELD_NUMBER

public static final int LAST_ATTEMPT_FIELD_NUMBER
Field Value
TypeDescription
int

NAME_FIELD_NUMBER

public static final int NAME_FIELD_NUMBER
Field Value
TypeDescription
int

PULL_MESSAGE_FIELD_NUMBER

public static final int PULL_MESSAGE_FIELD_NUMBER
Field Value
TypeDescription
int

RESPONSE_COUNT_FIELD_NUMBER

public static final int RESPONSE_COUNT_FIELD_NUMBER
Field Value
TypeDescription
int

SCHEDULE_TIME_FIELD_NUMBER

public static final int SCHEDULE_TIME_FIELD_NUMBER
Field Value
TypeDescription
int

VIEW_FIELD_NUMBER

public static final int VIEW_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static Task getDefaultInstance()
Returns
TypeDescription
Task

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static Task.Builder newBuilder()
Returns
TypeDescription
Task.Builder

newBuilder(Task prototype)

public static Task.Builder newBuilder(Task prototype)
Parameter
NameDescription
prototypeTask
Returns
TypeDescription
Task.Builder

parseDelimitedFrom(InputStream input)

public static Task parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Task
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Task parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Task
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static Task parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
Task
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static Task parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Task
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static Task parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
Task
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static Task parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Task
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static Task parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
Task
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static Task parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Task
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static Task parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Task
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Task parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Task
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static Task parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
Task
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static Task parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Task
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<Task> parser()
Returns
TypeDescription
Parser<Task>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
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.v2beta3.AppEngineHttpRequest app_engine_http_request = 3;

Returns
TypeDescription
AppEngineHttpRequest

The appEngineHttpRequest.

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.v2beta3.AppEngineHttpRequest app_engine_http_request = 3;

Returns
TypeDescription
AppEngineHttpRequestOrBuilder

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;

Returns
TypeDescription
Timestamp

The createTime.

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;

Returns
TypeDescription
TimestampOrBuilder

getDefaultInstanceForType()

public Task getDefaultInstanceForType()
Returns
TypeDescription
Task

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 = 6;

Returns
TypeDescription
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 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 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 = 12;

Returns
TypeDescription
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 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 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 = 12;

Returns
TypeDescription
DurationOrBuilder

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.v2beta3.Attempt first_attempt = 8;

Returns
TypeDescription
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.v2beta3.Attempt first_attempt = 8;

Returns
TypeDescription
AttemptOrBuilder

getHttpRequest()

public HttpRequest getHttpRequest()

HTTP request that is sent to the task's target.

An HTTP task is a task that has HttpRequest set.

.google.cloud.tasks.v2beta3.HttpRequest http_request = 11;

Returns
TypeDescription
HttpRequest

The httpRequest.

getHttpRequestOrBuilder()

public HttpRequestOrBuilder getHttpRequestOrBuilder()

HTTP request that is sent to the task's target.

An HTTP task is a task that has HttpRequest set.

.google.cloud.tasks.v2beta3.HttpRequest http_request = 11;

Returns
TypeDescription
HttpRequestOrBuilder

getLastAttempt()

public Attempt getLastAttempt()

Output only. The status of the task's last attempt.

.google.cloud.tasks.v2beta3.Attempt last_attempt = 9;

Returns
TypeDescription
Attempt

The lastAttempt.

getLastAttemptOrBuilder()

public AttemptOrBuilder getLastAttemptOrBuilder()

Output only. The status of the task's last attempt.

.google.cloud.tasks.v2beta3.Attempt last_attempt = 9;

Returns
TypeDescription
AttemptOrBuilder

getName()

public String 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 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.

string name = 1;

Returns
TypeDescription
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 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.

string name = 1;

Returns
TypeDescription
ByteString

The bytes for name.

getParserForType()

public Parser<Task> getParserForType()
Returns
TypeDescription
Parser<Task>
Overrides

getPayloadTypeCase()

public Task.PayloadTypeCase getPayloadTypeCase()
Returns
TypeDescription
Task.PayloadTypeCase

getPullMessage()

public PullMessage getPullMessage()

Pull Message contained in a task in a PULL queue type. This payload type cannot be explicitly set through Cloud Tasks API. Its purpose, currently is to provide backward compatibility with App Engine Task Queue pull queues to provide a way to inspect contents of pull tasks through the CloudTasks.GetTask.

.google.cloud.tasks.v2beta3.PullMessage pull_message = 13;

Returns
TypeDescription
PullMessage

The pullMessage.

getPullMessageOrBuilder()

public PullMessageOrBuilder getPullMessageOrBuilder()

Pull Message contained in a task in a PULL queue type. This payload type cannot be explicitly set through Cloud Tasks API. Its purpose, currently is to provide backward compatibility with App Engine Task Queue pull queues to provide a way to inspect contents of pull tasks through the CloudTasks.GetTask.

.google.cloud.tasks.v2beta3.PullMessage pull_message = 13;

Returns
TypeDescription
PullMessageOrBuilder

getResponseCount()

public int getResponseCount()

Output only. The number of attempts which have received a response.

int32 response_count = 7;

Returns
TypeDescription
int

The responseCount.

getScheduleTime()

public Timestamp getScheduleTime()

The time when the task is scheduled to be attempted.

For App Engine queues, this is when the task will be attempted or retried.

schedule_time will be truncated to the nearest microsecond.

.google.protobuf.Timestamp schedule_time = 4;

Returns
TypeDescription
Timestamp

The scheduleTime.

getScheduleTimeOrBuilder()

public TimestampOrBuilder getScheduleTimeOrBuilder()

The time when the task is scheduled to be attempted.

For App Engine queues, this is when the task will be attempted or retried.

schedule_time will be truncated to the nearest microsecond.

.google.protobuf.Timestamp schedule_time = 4;

Returns
TypeDescription
TimestampOrBuilder

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

getView()

public Task.View getView()

Output only. The view specifies which subset of the Task has been returned.

.google.cloud.tasks.v2beta3.Task.View view = 10;

Returns
TypeDescription
Task.View

The view.

getViewValue()

public int getViewValue()

Output only. The view specifies which subset of the Task has been returned.

.google.cloud.tasks.v2beta3.Task.View view = 10;

Returns
TypeDescription
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.v2beta3.AppEngineHttpRequest app_engine_http_request = 3;

Returns
TypeDescription
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;

Returns
TypeDescription
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 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 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 = 12;

Returns
TypeDescription
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.v2beta3.Attempt first_attempt = 8;

Returns
TypeDescription
boolean

Whether the firstAttempt field is set.

hasHttpRequest()

public boolean hasHttpRequest()

HTTP request that is sent to the task's target.

An HTTP task is a task that has HttpRequest set.

.google.cloud.tasks.v2beta3.HttpRequest http_request = 11;

Returns
TypeDescription
boolean

Whether the httpRequest field is set.

hasLastAttempt()

public boolean hasLastAttempt()

Output only. The status of the task's last attempt.

.google.cloud.tasks.v2beta3.Attempt last_attempt = 9;

Returns
TypeDescription
boolean

Whether the lastAttempt field is set.

hasPullMessage()

public boolean hasPullMessage()

Pull Message contained in a task in a PULL queue type. This payload type cannot be explicitly set through Cloud Tasks API. Its purpose, currently is to provide backward compatibility with App Engine Task Queue pull queues to provide a way to inspect contents of pull tasks through the CloudTasks.GetTask.

.google.cloud.tasks.v2beta3.PullMessage pull_message = 13;

Returns
TypeDescription
boolean

Whether the pullMessage field is set.

hasScheduleTime()

public boolean hasScheduleTime()

The time when the task is scheduled to be attempted.

For App Engine queues, this is when the task will be attempted or retried.

schedule_time will be truncated to the nearest microsecond.

.google.protobuf.Timestamp schedule_time = 4;

Returns
TypeDescription
boolean

Whether the scheduleTime field is set.

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public Task.Builder newBuilderForType()
Returns
TypeDescription
Task.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected Task.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
Task.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public Task.Builder toBuilder()
Returns
TypeDescription
Task.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException