Package com.google.cloud.tasks.v2beta2

Interface CreateTaskRequestOrBuilder

All Superinterfaces:
com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder
All Known Implementing Classes:
CreateTaskRequest, CreateTaskRequest.Builder
@Generated public interface CreateTaskRequestOrBuilder extends com.google.protobuf.MessageOrBuilder

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    getParent()
    Required.
    com.google.protobuf.ByteString
    getParentBytes()
    Required.
    Task.View
    getResponseView()
    The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned.
    int
    getResponseViewValue()
    The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned.
    Task
    getTask()
    Required.
    TaskOrBuilder
    getTaskOrBuilder()
    Required.
    boolean
    hasTask()
    Required.

    Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

    isInitialized

    Methods inherited from interface com.google.protobuf.MessageOrBuilder

    findInitializationErrors, getAllFields, getDefaultInstanceForType, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

  • Method Details

    • getParent

      String getParent()
       Required. The queue name. For example:
 `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`

 The queue must already exist.
      string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
      Returns:
      The parent.

    • getParentBytes

      com.google.protobuf.ByteString getParentBytes()
       Required. The queue name. For example:
 `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`

 The queue must already exist.
      string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
      Returns:
      The bytes for parent.

    • hasTask

      boolean hasTask()
       Required. The task to add.

 Task names have the following format:
 `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
 The user can optionally specify a task
 [name][google.cloud.tasks.v2beta2.Task.name]. If a name is not specified
 then the system will generate a random unique task id, which will be set in
 the task returned in the [response][google.cloud.tasks.v2beta2.Task.name].

 If [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] is not
 set or is in the past then Cloud Tasks will set it to the current time.

 Task De-duplication:

 Explicitly specifying a task ID enables task de-duplication.  If
 a task's ID is identical to that of an existing task or a task
 that was deleted or completed recently then the call will fail
 with [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS].
 If the task's queue was created using Cloud Tasks, then another task with
 the same name can't be created for ~1 hour after the original task was
 deleted or completed. If the task's queue was created using queue.yaml or
 queue.xml, then another task with the same name can't be created
 for ~9 days after the original task was deleted or completed.

 Because there is an extra lookup cost to identify duplicate task
 names, these [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]
 calls have significantly increased latency. Using hashed strings for the
 task id or for the prefix of the task id is recommended. Choosing task ids
 that are sequential or have sequential prefixes, for example using a
 timestamp, causes an increase in latency and error rates in all
 task commands. The infrastructure relies on an approximately
 uniform distribution of task ids to store and serve tasks
 efficiently.
      .google.cloud.tasks.v2beta2.Task task = 2 [(.google.api.field_behavior) = REQUIRED];
      Returns:
      Whether the task field is set.

    • getTask

      Task getTask()
       Required. The task to add.

 Task names have the following format:
 `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
 The user can optionally specify a task
 [name][google.cloud.tasks.v2beta2.Task.name]. If a name is not specified
 then the system will generate a random unique task id, which will be set in
 the task returned in the [response][google.cloud.tasks.v2beta2.Task.name].

 If [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] is not
 set or is in the past then Cloud Tasks will set it to the current time.

 Task De-duplication:

 Explicitly specifying a task ID enables task de-duplication.  If
 a task's ID is identical to that of an existing task or a task
 that was deleted or completed recently then the call will fail
 with [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS].
 If the task's queue was created using Cloud Tasks, then another task with
 the same name can't be created for ~1 hour after the original task was
 deleted or completed. If the task's queue was created using queue.yaml or
 queue.xml, then another task with the same name can't be created
 for ~9 days after the original task was deleted or completed.

 Because there is an extra lookup cost to identify duplicate task
 names, these [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]
 calls have significantly increased latency. Using hashed strings for the
 task id or for the prefix of the task id is recommended. Choosing task ids
 that are sequential or have sequential prefixes, for example using a
 timestamp, causes an increase in latency and error rates in all
 task commands. The infrastructure relies on an approximately
 uniform distribution of task ids to store and serve tasks
 efficiently.
      .google.cloud.tasks.v2beta2.Task task = 2 [(.google.api.field_behavior) = REQUIRED];
      Returns:
      The task.

    • getTaskOrBuilder

      TaskOrBuilder getTaskOrBuilder()
       Required. The task to add.

 Task names have the following format:
 `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
 The user can optionally specify a task
 [name][google.cloud.tasks.v2beta2.Task.name]. If a name is not specified
 then the system will generate a random unique task id, which will be set in
 the task returned in the [response][google.cloud.tasks.v2beta2.Task.name].

 If [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] is not
 set or is in the past then Cloud Tasks will set it to the current time.

 Task De-duplication:

 Explicitly specifying a task ID enables task de-duplication.  If
 a task's ID is identical to that of an existing task or a task
 that was deleted or completed recently then the call will fail
 with [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS].
 If the task's queue was created using Cloud Tasks, then another task with
 the same name can't be created for ~1 hour after the original task was
 deleted or completed. If the task's queue was created using queue.yaml or
 queue.xml, then another task with the same name can't be created
 for ~9 days after the original task was deleted or completed.

 Because there is an extra lookup cost to identify duplicate task
 names, these [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]
 calls have significantly increased latency. Using hashed strings for the
 task id or for the prefix of the task id is recommended. Choosing task ids
 that are sequential or have sequential prefixes, for example using a
 timestamp, causes an increase in latency and error rates in all
 task commands. The infrastructure relies on an approximately
 uniform distribution of task ids to store and serve tasks
 efficiently.
      .google.cloud.tasks.v2beta2.Task task = 2 [(.google.api.field_behavior) = REQUIRED];

    • getResponseViewValue

      int getResponseViewValue()
       The response_view specifies which subset of the
 [Task][google.cloud.tasks.v2beta2.Task] will be returned.

 By default response_view is
 [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
 retrieved by default because some data, such as payloads, might be
 desirable to return only when needed because of its large size or because
 of the sensitivity of data that it contains.

 Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
 requires `cloudtasks.tasks.fullView` [Google
 IAM](https://cloud.google.com/iam/) permission on the
 [Task][google.cloud.tasks.v2beta2.Task] resource.
      .google.cloud.tasks.v2beta2.Task.View response_view = 3;
      Returns:
      The enum numeric value on the wire for responseView.

    • getResponseView

      Task.View getResponseView()
       The response_view specifies which subset of the
 [Task][google.cloud.tasks.v2beta2.Task] will be returned.

 By default response_view is
 [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
 retrieved by default because some data, such as payloads, might be
 desirable to return only when needed because of its large size or because
 of the sensitivity of data that it contains.

 Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
 requires `cloudtasks.tasks.fullView` [Google
 IAM](https://cloud.google.com/iam/) permission on the
 [Task][google.cloud.tasks.v2beta2.Task] resource.
      .google.cloud.tasks.v2beta2.Task.View response_view = 3;
      Returns:
      The responseView.