From c927a72739111f9c3f522fbcdf605d0853bbf9c6 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 21 Aug 2019 09:42:05 -0700 Subject: [PATCH] Update documentation (via synth). (#9069) --- .../tasks_v2/gapic/cloud_tasks_client.py | 62 +- .../cloud/tasks_v2/proto/cloudtasks.proto | 172 +++-- .../cloud/tasks_v2/proto/cloudtasks_pb2.py | 213 +++--- tasks/google/cloud/tasks_v2/proto/queue.proto | 12 +- .../google/cloud/tasks_v2/proto/queue_pb2.py | 38 +- .../google/cloud/tasks_v2/proto/target.proto | 26 +- .../google/cloud/tasks_v2/proto/target_pb2.py | 42 +- tasks/google/cloud/tasks_v2/proto/task.proto | 11 +- tasks/google/cloud/tasks_v2/proto/task_pb2.py | 20 +- .../tasks_v2beta2/gapic/cloud_tasks_client.py | 122 ++- .../google/cloud/tasks_v2beta2/gapic/enums.py | 145 ---- .../tasks_v2beta2/proto/cloudtasks.proto | 720 +++++++++--------- .../tasks_v2beta2/proto/cloudtasks_pb2.py | 350 +++++---- .../proto/cloudtasks_pb2_grpc.py | 124 ++- .../cloud/tasks_v2beta2/proto/queue.proto | 156 ++-- .../cloud/tasks_v2beta2/proto/queue_pb2.py | 29 +- .../cloud/tasks_v2beta2/proto/target.proto | 181 +++-- .../cloud/tasks_v2beta2/proto/target_pb2.py | 79 +- .../cloud/tasks_v2beta2/proto/task.proto | 78 +- .../cloud/tasks_v2beta2/proto/task_pb2.py | 33 +- .../tasks_v2beta3/gapic/cloud_tasks_client.py | 62 +- .../tasks_v2beta3/proto/cloudtasks.proto | 172 +++-- .../tasks_v2beta3/proto/cloudtasks_pb2.py | 213 +++--- .../cloud/tasks_v2beta3/proto/queue.proto | 7 +- .../cloud/tasks_v2beta3/proto/queue_pb2.py | 25 +- .../cloud/tasks_v2beta3/proto/target.proto | 12 +- .../cloud/tasks_v2beta3/proto/target_pb2.py | 37 +- .../cloud/tasks_v2beta3/proto/task.proto | 7 +- .../cloud/tasks_v2beta3/proto/task_pb2.py | 17 +- tasks/synth.metadata | 10 +- 30 files changed, 1629 insertions(+), 1546 deletions(-) diff --git a/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client.py b/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client.py index 78ee733ae852..06e92dc49df5 100644 --- a/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client.py +++ b/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client.py @@ -267,9 +267,7 @@ def list_queues( ... pass Args: - parent (str): Required. - - The location name. For example: + parent (str): Required. The location name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` filter_ (str): ``filter`` can be used to specify a subset of queues. Any ``Queue`` field can be used as a filter and several operators as supported. For @@ -370,9 +368,7 @@ def get_queue( >>> response = client.get_queue(name) Args: - name (str): Required. - - The resource name of the queue. For example: + name (str): Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -456,16 +452,12 @@ def create_queue( >>> response = client.create_queue(parent, queue) Args: - parent (str): Required. - - The location name in which the queue will be created. For example: - ``projects/PROJECT_ID/locations/LOCATION_ID`` + parent (str): Required. The location name in which the queue will be created. For + example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of allowed locations can be obtained by calling Cloud Tasks' implementation of ``ListLocations``. - queue (Union[dict, ~google.cloud.tasks_v2.types.Queue]): Required. - - The queue to create. + queue (Union[dict, ~google.cloud.tasks_v2.types.Queue]): Required. The queue to create. ``Queue's name`` cannot be the same as an existing queue. @@ -554,9 +546,7 @@ def update_queue( >>> response = client.update_queue(queue) Args: - queue (Union[dict, ~google.cloud.tasks_v2.types.Queue]): Required. - - The queue to create or update. + queue (Union[dict, ~google.cloud.tasks_v2.types.Queue]): Required. The queue to create or update. The queue's ``name`` must be specified. @@ -653,9 +643,7 @@ def delete_queue( >>> client.delete_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -727,9 +715,7 @@ def purge_queue( >>> response = client.purge_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -803,9 +789,7 @@ def pause_queue( >>> response = client.pause_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -884,9 +868,7 @@ def resume_queue( >>> response = client.resume_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -1239,9 +1221,7 @@ def list_tasks( ... pass Args: - parent (str): Required. - - The queue name. For example: + parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view (~google.cloud.tasks_v2.types.View): The response\_view specifies which subset of the ``Task`` will be returned. @@ -1344,9 +1324,7 @@ def get_task( >>> response = client.get_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view (~google.cloud.tasks_v2.types.View): The response\_view specifies which subset of the ``Task`` will be returned. @@ -1436,15 +1414,11 @@ def create_task( >>> response = client.create_task(parent, task) Args: - parent (str): Required. - - The queue name. For example: + parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` The queue must already exist. - task (Union[dict, ~google.cloud.tasks_v2.types.Task]): Required. - - The task to add. + task (Union[dict, ~google.cloud.tasks_v2.types.Task]): Required. The task to add. Task names have the following format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``. @@ -1562,9 +1536,7 @@ def delete_task( >>> client.delete_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -1652,9 +1624,7 @@ def run_task( >>> response = client.run_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view (~google.cloud.tasks_v2.types.View): The response\_view specifies which subset of the ``Task`` will be returned. diff --git a/tasks/google/cloud/tasks_v2/proto/cloudtasks.proto b/tasks/google/cloud/tasks_v2/proto/cloudtasks.proto index e287880c37b3..f948426a3655 100644 --- a/tasks/google/cloud/tasks_v2/proto/cloudtasks.proto +++ b/tasks/google/cloud/tasks_v2/proto/cloudtasks.proto @@ -18,6 +18,8 @@ syntax = "proto3"; package google.cloud.tasks.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/api/resource.proto"; import "google/cloud/tasks/v2/queue.proto"; import "google/cloud/tasks/v2/task.proto"; @@ -25,7 +27,6 @@ import "google/iam/v1/iam_policy.proto"; import "google/iam/v1/policy.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/rpc/code.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks"; option java_multiple_files = true; @@ -36,6 +37,9 @@ option objc_class_prefix = "TASKS"; // Cloud Tasks allows developers to manage the execution of background // work in their applications. service CloudTasks { + option (google.api.default_host) = "cloudtasks.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Lists queues. // // Queues are returned in lexicographical order. @@ -43,6 +47,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2/{parent=projects/*/locations/*}/queues" }; + option (google.api.method_signature) = "parent"; } // Gets a queue. @@ -50,6 +55,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2/{name=projects/*/locations/*/queues/*}" }; + option (google.api.method_signature) = "name"; } // Creates a queue. @@ -69,6 +75,7 @@ service CloudTasks { post: "/v2/{parent=projects/*/locations/*}/queues" body: "queue" }; + option (google.api.method_signature) = "parent,queue"; } // Updates a queue. @@ -91,6 +98,7 @@ service CloudTasks { patch: "/v2/{queue.name=projects/*/locations/*/queues/*}" body: "queue" }; + option (google.api.method_signature) = "queue,update_mask"; } // Deletes a queue. @@ -110,6 +118,7 @@ service CloudTasks { option (google.api.http) = { delete: "/v2/{name=projects/*/locations/*/queues/*}" }; + option (google.api.method_signature) = "name"; } // Purges a queue by deleting all of its tasks. @@ -123,6 +132,7 @@ service CloudTasks { post: "/v2/{name=projects/*/locations/*/queues/*}:purge" body: "*" }; + option (google.api.method_signature) = "name"; } // Pauses the queue. @@ -137,6 +147,7 @@ service CloudTasks { post: "/v2/{name=projects/*/locations/*/queues/*}:pause" body: "*" }; + option (google.api.method_signature) = "name"; } // Resume a queue. @@ -157,6 +168,7 @@ service CloudTasks { post: "/v2/{name=projects/*/locations/*/queues/*}:resume" body: "*" }; + option (google.api.method_signature) = "name"; } // Gets the access control policy for a [Queue][google.cloud.tasks.v2.Queue]. @@ -173,6 +185,7 @@ service CloudTasks { post: "/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource"; } // Sets the access control policy for a [Queue][google.cloud.tasks.v2.Queue]. Replaces any existing @@ -191,6 +204,7 @@ service CloudTasks { post: "/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource,policy"; } // Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2.Queue]. @@ -205,6 +219,7 @@ service CloudTasks { post: "/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions" body: "*" }; + option (google.api.method_signature) = "resource,permissions"; } // Lists the tasks in a queue. @@ -220,6 +235,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2/{parent=projects/*/locations/*/queues/*}/tasks" }; + option (google.api.method_signature) = "parent"; } // Gets a task. @@ -227,6 +243,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2/{name=projects/*/locations/*/queues/*/tasks/*}" }; + option (google.api.method_signature) = "name"; } // Creates a task and adds it to a queue. @@ -239,6 +256,7 @@ service CloudTasks { post: "/v2/{parent=projects/*/locations/*/queues/*}/tasks" body: "*" }; + option (google.api.method_signature) = "parent,task"; } // Deletes a task. @@ -250,6 +268,7 @@ service CloudTasks { option (google.api.http) = { delete: "/v2/{name=projects/*/locations/*/queues/*/tasks/*}" }; + option (google.api.method_signature) = "name"; } // Forces a task to run now. @@ -281,16 +300,20 @@ service CloudTasks { post: "/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run" body: "*" }; + option (google.api.method_signature) = "name"; } } // Request message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues]. message ListQueuesRequest { - // Required. - // - // The location name. + // Required. The location name. // For example: `projects/PROJECT_ID/locations/LOCATION_ID` - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "locations.googleapis.com/Location" + } + ]; // `filter` can be used to specify a subset of queues. Any [Queue][google.cloud.tasks.v2.Queue] // field can be used as a filter and several operators as supported. @@ -344,45 +367,47 @@ message ListQueuesResponse { // Request message for [GetQueue][google.cloud.tasks.v2.CloudTasks.GetQueue]. message GetQueueRequest { - // Required. - // - // The resource name of the queue. For example: + // Required. The resource name of the queue. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue]. message CreateQueueRequest { - // Required. - // - // The location name in which the queue will be created. + // Required. The location name in which the queue will be created. // For example: `projects/PROJECT_ID/locations/LOCATION_ID` // // The list of allowed locations can be obtained by calling Cloud // Tasks' implementation of // [ListLocations][google.cloud.location.Locations.ListLocations]. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "locations.googleapis.com/Location" + } + ]; - // Required. - // - // The queue to create. + // Required. The queue to create. // // [Queue's name][google.cloud.tasks.v2.Queue.name] cannot be the same as an existing queue. - Queue queue = 2; + Queue queue = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue]. message UpdateQueueRequest { - // Required. - // - // The queue to create or update. + // Required. The queue to create or update. // // The queue's [name][google.cloud.tasks.v2.Queue.name] must be specified. // // Output only fields cannot be modified using UpdateQueue. // Any value specified for an output only field will be ignored. // The queue's [name][google.cloud.tasks.v2.Queue.name] cannot be changed. - Queue queue = 1; + Queue queue = 1 [(google.api.field_behavior) = REQUIRED]; // A mask used to specify which fields of the queue are being updated. // @@ -392,47 +417,62 @@ message UpdateQueueRequest { // Request message for [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue]. message DeleteQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue]. message PurgeQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue]. message PauseQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue]. message ResumeQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks]. message ListTasksRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudtasks.googleapis.com/Queue" + } + ]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be // returned. @@ -487,11 +527,14 @@ message ListTasksResponse { // Request message for getting a task using [GetTask][google.cloud.tasks.v2.CloudTasks.GetTask]. message GetTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be // returned. @@ -510,17 +553,18 @@ message GetTaskRequest { // Request message for [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask]. message CreateTaskRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` // // The queue must already exist. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudtasks.googleapis.com/Queue" + } + ]; - // Required. - // - // The task to add. + // Required. The task to add. // // Task names have the following format: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. @@ -553,7 +597,7 @@ message CreateTaskRequest { // task commands. The infrastructure relies on an approximately // uniform distribution of task ids to store and serve tasks // efficiently. - Task task = 2; + Task task = 2 [(google.api.field_behavior) = REQUIRED]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be // returned. @@ -573,21 +617,27 @@ message CreateTaskRequest { // Request message for deleting a task using // [DeleteTask][google.cloud.tasks.v2.CloudTasks.DeleteTask]. message DeleteTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; } // Request message for forcing a task to run now using // [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask]. message RunTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be // returned. diff --git a/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2.py b/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2.py index 5e0fddf683be..55beb9139d88 100644 --- a/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2.py +++ b/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2.py @@ -16,6 +16,8 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2.proto import ( queue_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2, @@ -27,7 +29,6 @@ from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2 from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 -from google.rpc import code_pb2 as google_dot_rpc_dot_code__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -38,10 +39,12 @@ "\n\031com.google.cloud.tasks.v2B\017CloudTasksProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\242\002\005TASKS" ), serialized_pb=_b( - '\n,google/cloud/tasks_v2/proto/cloudtasks.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a\'google/cloud/tasks_v2/proto/queue.proto\x1a&google/cloud/tasks_v2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x15google/rpc/code.proto"Z\n\x11ListQueuesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"[\n\x12ListQueuesResponse\x12,\n\x06queues\x18\x01 \x03(\x0b\x32\x1c.google.cloud.tasks.v2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1f\n\x0fGetQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"Q\n\x12\x43reateQueueRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12+\n\x05queue\x18\x02 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.Queue"r\n\x12UpdateQueueRequest\x12+\n\x05queue\x18\x01 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.Queue\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask""\n\x12\x44\x65leteQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11PurgeQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11PauseQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t""\n\x12ResumeQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x82\x01\n\x10ListTasksRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"X\n\x11ListTasksResponse\x12*\n\x05tasks\x18\x01 \x03(\x0b\x32\x1b.google.cloud.tasks.v2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"W\n\x0eGetTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"\x87\x01\n\x11\x43reateTaskRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12)\n\x04task\x18\x02 \x01(\x0b\x32\x1b.google.cloud.tasks.v2.Task\x12\x37\n\rresponse_view\x18\x03 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"!\n\x11\x44\x65leteTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"W\n\x0eRunTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View2\xdf\x12\n\nCloudTasks\x12\x95\x01\n\nListQueues\x12(.google.cloud.tasks.v2.ListQueuesRequest\x1a).google.cloud.tasks.v2.ListQueuesResponse"2\x82\xd3\xe4\x93\x02,\x12*/v2/{parent=projects/*/locations/*}/queues\x12\x84\x01\n\x08GetQueue\x12&.google.cloud.tasks.v2.GetQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"2\x82\xd3\xe4\x93\x02,\x12*/v2/{name=projects/*/locations/*/queues/*}\x12\x91\x01\n\x0b\x43reateQueue\x12).google.cloud.tasks.v2.CreateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"9\x82\xd3\xe4\x93\x02\x33"*/v2/{parent=projects/*/locations/*}/queues:\x05queue\x12\x97\x01\n\x0bUpdateQueue\x12).google.cloud.tasks.v2.UpdateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"?\x82\xd3\xe4\x93\x02\x39\x32\x30/v2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\x12\x84\x01\n\x0b\x44\x65leteQueue\x12).google.cloud.tasks.v2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty"2\x82\xd3\xe4\x93\x02,**/v2/{name=projects/*/locations/*/queues/*}\x12\x91\x01\n\nPurgeQueue\x12(.google.cloud.tasks.v2.PurgeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue";\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:purge:\x01*\x12\x91\x01\n\nPauseQueue\x12(.google.cloud.tasks.v2.PauseQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue";\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:pause:\x01*\x12\x94\x01\n\x0bResumeQueue\x12).google.cloud.tasks.v2.ResumeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"<\x82\xd3\xe4\x93\x02\x36"1/v2/{name=projects/*/locations/*/queues/*}:resume:\x01*\x12\x91\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"F\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\x12\x91\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"F\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\x12\xb7\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"L\x82\xd3\xe4\x93\x02\x46"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\x12\x9a\x01\n\tListTasks\x12\'.google.cloud.tasks.v2.ListTasksRequest\x1a(.google.cloud.tasks.v2.ListTasksResponse":\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{parent=projects/*/locations/*/queues/*}/tasks\x12\x89\x01\n\x07GetTask\x12%.google.cloud.tasks.v2.GetTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task":\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{name=projects/*/locations/*/queues/*/tasks/*}\x12\x92\x01\n\nCreateTask\x12(.google.cloud.tasks.v2.CreateTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"=\x82\xd3\xe4\x93\x02\x37"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\x12\x8a\x01\n\nDeleteTask\x12(.google.cloud.tasks.v2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty":\x82\xd3\xe4\x93\x02\x34*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\x12\x90\x01\n\x07RunTask\x12%.google.cloud.tasks.v2.RunTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"A\x82\xd3\xe4\x93\x02;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*Br\n\x19\x63om.google.cloud.tasks.v2B\x0f\x43loudTasksProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\xa2\x02\x05TASKSb\x06proto3' + '\n,google/cloud/tasks_v2/proto/cloudtasks.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\'google/cloud/tasks_v2/proto/queue.proto\x1a&google/cloud/tasks_v2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x85\x01\n\x11ListQueuesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"[\n\x12ListQueuesResponse\x12,\n\x06queues\x18\x01 \x03(\x0b\x32\x1c.google.cloud.tasks.v2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x81\x01\n\x12\x43reateQueueRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x30\n\x05queue\x18\x02 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02"w\n\x12UpdateQueueRequest\x12\x30\n\x05queue\x18\x01 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xab\x01\n\x10ListTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"X\n\x11ListTasksResponse\x12*\n\x05tasks\x18\x01 \x03(\x0b\x32\x1b.google.cloud.tasks.v2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x7f\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"\xb5\x01\n\x11\x43reateTaskRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12.\n\x04task\x18\x02 \x01(\x0b\x32\x1b.google.cloud.tasks.v2.TaskB\x03\xe0\x41\x02\x12\x37\n\rresponse_view\x18\x03 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x7f\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View2\xdd\x14\n\nCloudTasks\x12\x9e\x01\n\nListQueues\x12(.google.cloud.tasks.v2.ListQueuesRequest\x1a).google.cloud.tasks.v2.ListQueuesResponse";\x82\xd3\xe4\x93\x02,\x12*/v2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x8b\x01\n\x08GetQueue\x12&.google.cloud.tasks.v2.GetQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"9\x82\xd3\xe4\x93\x02,\x12*/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa0\x01\n\x0b\x43reateQueue\x12).google.cloud.tasks.v2.CreateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"H\x82\xd3\xe4\x93\x02\x33"*/v2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xab\x01\n\x0bUpdateQueue\x12).google.cloud.tasks.v2.UpdateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"S\x82\xd3\xe4\x93\x02\x39\x32\x30/v2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x8b\x01\n\x0b\x44\x65leteQueue\x12).google.cloud.tasks.v2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty"9\x82\xd3\xe4\x93\x02,**/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\x98\x01\n\nPurgeQueue\x12(.google.cloud.tasks.v2.PurgeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\x98\x01\n\nPauseQueue\x12(.google.cloud.tasks.v2.PauseQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\x9b\x01\n\x0bResumeQueue\x12).google.cloud.tasks.v2.ResumeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"C\x82\xd3\xe4\x93\x02\x36"1/v2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\x9c\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"Q\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa3\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"X\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xce\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"c\x82\xd3\xe4\x93\x02\x46"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xa3\x01\n\tListTasks\x12\'.google.cloud.tasks.v2.ListTasksRequest\x1a(.google.cloud.tasks.v2.ListTasksResponse"C\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x90\x01\n\x07GetTask\x12%.google.cloud.tasks.v2.GetTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"A\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa0\x01\n\nCreateTask\x12(.google.cloud.tasks.v2.CreateTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"K\x82\xd3\xe4\x93\x02\x37"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x91\x01\n\nDeleteTask\x12(.google.cloud.tasks.v2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02\x34*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\x97\x01\n\x07RunTask\x12%.google.cloud.tasks.v2.RunTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"H\x82\xd3\xe4\x93\x02;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBr\n\x19\x63om.google.cloud.tasks.v2B\x0f\x43loudTasksProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\xa2\x02\x05TASKSb\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.DESCRIPTOR, @@ -49,7 +52,6 @@ google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, - google_dot_rpc_dot_code__pb2.DESCRIPTOR, ], ) @@ -76,7 +78,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!locations.googleapis.com/Location" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -142,8 +146,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=355, - serialized_end=445, + serialized_start=391, + serialized_end=524, ) @@ -199,8 +203,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=447, - serialized_end=538, + serialized_start=526, + serialized_end=617, ) @@ -226,7 +230,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -238,8 +244,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=540, - serialized_end=571, + serialized_start=619, + serialized_end=691, ) @@ -265,7 +271,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!locations.googleapis.com/Location" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -283,7 +291,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -295,8 +303,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=573, - serialized_end=654, + serialized_start=694, + serialized_end=823, ) @@ -322,7 +330,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -352,8 +360,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=656, - serialized_end=770, + serialized_start=825, + serialized_end=944, ) @@ -379,7 +387,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -391,8 +401,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=772, - serialized_end=806, + serialized_start=946, + serialized_end=1021, ) @@ -418,7 +428,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -430,8 +442,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=808, - serialized_end=841, + serialized_start=1023, + serialized_end=1097, ) @@ -457,7 +469,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -469,8 +483,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=843, - serialized_end=876, + serialized_start=1099, + serialized_end=1173, ) @@ -496,7 +510,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -508,8 +524,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=878, - serialized_end=912, + serialized_start=1175, + serialized_end=1250, ) @@ -535,7 +551,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -601,8 +619,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=915, - serialized_end=1045, + serialized_start=1253, + serialized_end=1424, ) @@ -658,8 +676,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1047, - serialized_end=1135, + serialized_start=1426, + serialized_end=1514, ) @@ -685,7 +703,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -715,8 +735,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1137, - serialized_end=1224, + serialized_start=1516, + serialized_end=1643, ) @@ -742,7 +762,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -760,7 +782,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -790,8 +812,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1227, - serialized_end=1362, + serialized_start=1646, + serialized_end=1827, ) @@ -817,7 +839,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ) ], @@ -829,8 +853,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1364, - serialized_end=1397, + serialized_start=1829, + serialized_end=1902, ) @@ -856,7 +880,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -886,8 +912,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1399, - serialized_end=1486, + serialized_start=1904, + serialized_end=2031, ) _LISTQUEUESRESPONSE.fields_by_name[ @@ -949,7 +975,7 @@ Attributes: parent: - Required. The location name. For example: + Required. The location name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` filter: ``filter`` can be used to specify a subset of queues. Any @@ -1022,7 +1048,7 @@ Attributes: name: - Required. The resource name of the queue. For example: + Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.GetQueueRequest) @@ -1042,14 +1068,14 @@ Attributes: parent: - Required. The location name in which the queue will be + Required. The location name in which the queue will be created. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of allowed locations can be obtained by calling Cloud Tasks' implementation of [ListLocations][google.cloud.location.Locati ons.ListLocations]. queue: - Required. The queue to create. [Queue's + Required. The queue to create. [Queue's name][google.cloud.tasks.v2.Queue.name] cannot be the same as an existing queue. """, @@ -1070,7 +1096,7 @@ Attributes: queue: - Required. The queue to create or update. The queue's + Required. The queue to create or update. The queue's [name][google.cloud.tasks.v2.Queue.name] must be specified. Output only fields cannot be modified using UpdateQueue. Any value specified for an output only field will be ignored. The @@ -1097,7 +1123,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.DeleteQueueRequest) @@ -1117,7 +1143,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.PurgeQueueRequest) @@ -1137,7 +1163,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.PauseQueueRequest) @@ -1157,7 +1183,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ResumeQueueRequest) @@ -1177,7 +1203,7 @@ Attributes: parent: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view: The response\_view specifies which subset of the @@ -1251,8 +1277,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: The response\_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be returned. By @@ -1284,11 +1310,11 @@ Attributes: parent: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` The queue must already exist. task: - Required. The task to add. Task names have the following + Required. The task to add. Task names have the following format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUE UE_ID/tasks/TASK_ID``. The user can optionally specify a task [name][google.cloud.tasks.v2.Task.name]. If a name is not @@ -1348,8 +1374,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.DeleteTaskRequest) ), @@ -1368,8 +1394,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: The response\_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be returned. By @@ -1391,15 +1417,32 @@ DESCRIPTOR._options = None +_LISTQUEUESREQUEST.fields_by_name["parent"]._options = None +_GETQUEUEREQUEST.fields_by_name["name"]._options = None +_CREATEQUEUEREQUEST.fields_by_name["parent"]._options = None +_CREATEQUEUEREQUEST.fields_by_name["queue"]._options = None +_UPDATEQUEUEREQUEST.fields_by_name["queue"]._options = None +_DELETEQUEUEREQUEST.fields_by_name["name"]._options = None +_PURGEQUEUEREQUEST.fields_by_name["name"]._options = None +_PAUSEQUEUEREQUEST.fields_by_name["name"]._options = None +_RESUMEQUEUEREQUEST.fields_by_name["name"]._options = None +_LISTTASKSREQUEST.fields_by_name["parent"]._options = None +_GETTASKREQUEST.fields_by_name["name"]._options = None +_CREATETASKREQUEST.fields_by_name["parent"]._options = None +_CREATETASKREQUEST.fields_by_name["task"]._options = None +_DELETETASKREQUEST.fields_by_name["name"]._options = None +_RUNTASKREQUEST.fields_by_name["name"]._options = None _CLOUDTASKS = _descriptor.ServiceDescriptor( name="CloudTasks", full_name="google.cloud.tasks.v2.CloudTasks", file=DESCRIPTOR, index=0, - serialized_options=None, - serialized_start=1489, - serialized_end=3888, + serialized_options=_b( + "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" + ), + serialized_start=2034, + serialized_end=4687, methods=[ _descriptor.MethodDescriptor( name="ListQueues", @@ -1409,7 +1452,7 @@ input_type=_LISTQUEUESREQUEST, output_type=_LISTQUEUESRESPONSE, serialized_options=_b( - "\202\323\344\223\002,\022*/v2/{parent=projects/*/locations/*}/queues" + "\202\323\344\223\002,\022*/v2/{parent=projects/*/locations/*}/queues\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -1420,7 +1463,7 @@ input_type=_GETQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - "\202\323\344\223\002,\022*/v2/{name=projects/*/locations/*/queues/*}" + "\202\323\344\223\002,\022*/v2/{name=projects/*/locations/*/queues/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1431,7 +1474,7 @@ input_type=_CREATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\0023"*/v2/{parent=projects/*/locations/*}/queues:\005queue' + '\202\323\344\223\0023"*/v2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue' ), ), _descriptor.MethodDescriptor( @@ -1442,7 +1485,7 @@ input_type=_UPDATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - "\202\323\344\223\002920/v2/{queue.name=projects/*/locations/*/queues/*}:\005queue" + "\202\323\344\223\002920/v2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask" ), ), _descriptor.MethodDescriptor( @@ -1453,7 +1496,7 @@ input_type=_DELETEQUEUEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\002,**/v2/{name=projects/*/locations/*/queues/*}" + "\202\323\344\223\002,**/v2/{name=projects/*/locations/*/queues/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1464,7 +1507,7 @@ input_type=_PURGEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:purge:\001*' + '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1475,7 +1518,7 @@ input_type=_PAUSEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:pause:\001*' + '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1486,7 +1529,7 @@ input_type=_RESUMEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\0026"1/v2/{name=projects/*/locations/*/queues/*}:resume:\001*' + '\202\323\344\223\0026"1/v2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1497,7 +1540,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, serialized_options=_b( - '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*' + '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource' ), ), _descriptor.MethodDescriptor( @@ -1508,7 +1551,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, serialized_options=_b( - '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*' + '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy' ), ), _descriptor.MethodDescriptor( @@ -1519,7 +1562,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, serialized_options=_b( - '\202\323\344\223\002F"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*' + '\202\323\344\223\002F"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions' ), ), _descriptor.MethodDescriptor( @@ -1530,7 +1573,7 @@ input_type=_LISTTASKSREQUEST, output_type=_LISTTASKSRESPONSE, serialized_options=_b( - "\202\323\344\223\0024\0222/v2/{parent=projects/*/locations/*/queues/*}/tasks" + "\202\323\344\223\0024\0222/v2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -1541,7 +1584,7 @@ input_type=_GETTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - "\202\323\344\223\0024\0222/v2/{name=projects/*/locations/*/queues/*/tasks/*}" + "\202\323\344\223\0024\0222/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1552,7 +1595,7 @@ input_type=_CREATETASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\0027"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\001*' + '\202\323\344\223\0027"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task' ), ), _descriptor.MethodDescriptor( @@ -1563,7 +1606,7 @@ input_type=_DELETETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\0024*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}" + "\202\323\344\223\0024*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1574,7 +1617,7 @@ input_type=_RUNTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\002;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*' + '\202\323\344\223\002;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name' ), ), ], diff --git a/tasks/google/cloud/tasks_v2/proto/queue.proto b/tasks/google/cloud/tasks_v2/proto/queue.proto index 05dd03d07fe2..ce6a90244d7b 100644 --- a/tasks/google/cloud/tasks_v2/proto/queue.proto +++ b/tasks/google/cloud/tasks_v2/proto/queue.proto @@ -17,11 +17,11 @@ syntax = "proto3"; package google.cloud.tasks.v2; -import "google/api/annotations.proto"; import "google/api/resource.proto"; import "google/cloud/tasks/v2/target.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks"; option java_multiple_files = true; @@ -32,6 +32,11 @@ option java_package = "com.google.cloud.tasks.v2"; // how those tasks are dispatched. Configurable properties include rate limits, // retry options, queue types, and others. message Queue { + option (google.api.resource) = { + type: "cloudtasks.googleapis.com/Queue" + pattern: "projects/{project}/locations/{location}/queues/{queue}" + }; + // State of the queue. enum State { // Unspecified state. @@ -175,8 +180,7 @@ message RateLimits { // If unspecified when the queue is created, Cloud Tasks will pick the // default. // - // * For [App Engine queues][google.cloud.tasks.v2.AppEngineHttpQueue], the maximum allowed value - // is 500. + // * The maximum allowed value is 500. // // // This field has the same meaning as @@ -205,7 +209,7 @@ message RateLimits { // value of // [max_dispatches_per_second][google.cloud.tasks.v2.RateLimits.max_dispatches_per_second]. // - // For App Engine queues that were created or updated using + // For queues that were created or updated using // `queue.yaml/xml`, `max_burst_size` is equal to // [bucket_size](https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size). // Since `max_burst_size` is output only, if diff --git a/tasks/google/cloud/tasks_v2/proto/queue_pb2.py b/tasks/google/cloud/tasks_v2/proto/queue_pb2.py index b3b91ae5be6b..e7ae7d7e2b16 100644 --- a/tasks/google/cloud/tasks_v2/proto/queue_pb2.py +++ b/tasks/google/cloud/tasks_v2/proto/queue_pb2.py @@ -15,13 +15,13 @@ _sym_db = _symbol_database.Default() -from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2.proto import ( target_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2, ) from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 +from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -32,14 +32,14 @@ "\n\031com.google.cloud.tasks.v2B\nQueueProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks" ), serialized_pb=_b( - '\n\'google/cloud/tasks_v2/proto/queue.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xff\x02\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12L\n\x1b\x61pp_engine_routing_override\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x36\n\x0brate_limits\x18\x03 \x01(\x0b\x32!.google.cloud.tasks.v2.RateLimits\x12\x38\n\x0cretry_config\x18\x04 \x01(\x0b\x32".google.cloud.tasks.v2.RetryConfig\x12\x31\n\x05state\x18\x05 \x01(\x0e\x32".google.cloud.tasks.v2.Queue.State\x12.\n\npurge_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05\x42\x65\n\x19\x63om.google.cloud.tasks.v2B\nQueueProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3' + '\n\'google/cloud/tasks_v2/proto/queue.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xdd\x03\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12L\n\x1b\x61pp_engine_routing_override\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x36\n\x0brate_limits\x18\x03 \x01(\x0b\x32!.google.cloud.tasks.v2.RateLimits\x12\x38\n\x0cretry_config\x18\x04 \x01(\x0b\x32".google.cloud.tasks.v2.RetryConfig\x12\x31\n\x05state\x18\x05 \x01(\x0e\x32".google.cloud.tasks.v2.Queue.State\x12.\n\npurge_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05\x42\x65\n\x19\x63om.google.cloud.tasks.v2B\nQueueProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3' ), dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -194,13 +194,15 @@ extensions=[], nested_types=[], enum_types=[_QUEUE_STATE], - serialized_options=None, + serialized_options=_b( + "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}" + ), is_extendable=False, syntax="proto3", extension_ranges=[], oneofs=[], serialized_start=231, - serialized_end=614, + serialized_end=708, ) @@ -274,8 +276,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=616, - serialized_end=722, + serialized_start=710, + serialized_end=816, ) @@ -385,8 +387,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=725, - serialized_end=934, + serialized_start=819, + serialized_end=1028, ) _QUEUE.fields_by_name[ @@ -537,11 +539,10 @@ max_dispatches_per_second: The maximum rate at which tasks are dispatched from this queue. If unspecified when the queue is created, Cloud Tasks - will pick the default. - For [App Engine - queues][google.cloud.tasks.v2.AppEngineHttpQueue], the - maximum allowed value is 500. This field has the same meaning - as `rate in queue.yaml/xml `_. + will pick the default. - The maximum allowed value is 500. + This field has the same meaning as `rate in queue.yaml/xml `_. max_burst_size: Output only. The max burst size. Max burst size limits how fast tasks in queue are processed when many tasks are in the @@ -560,10 +561,10 @@ es\_per\_second]. Cloud Tasks will pick the value of ``max_burst_size`` based on the value of [max\_dispatches\_per \_second][google.cloud.tasks.v2.RateLimits.max\_dispatches\_pe - r\_second]. For App Engine queues that were created or - updated using ``queue.yaml/xml``, ``max_burst_size`` is equal - to `bucket\_size `_. Since + r\_second]. For queues that were created or updated using + ``queue.yaml/xml``, ``max_burst_size`` is equal to + `bucket\_size `_. Since ``max_burst_size`` is output only, if [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue] is called on a queue created by ``queue.yaml/xml``, @@ -684,4 +685,5 @@ DESCRIPTOR._options = None +_QUEUE._options = None # @@protoc_insertion_point(module_scope) diff --git a/tasks/google/cloud/tasks_v2/proto/target.proto b/tasks/google/cloud/tasks_v2/proto/target.proto index 2943a40587ec..acd38fedee3a 100644 --- a/tasks/google/cloud/tasks_v2/proto/target.proto +++ b/tasks/google/cloud/tasks_v2/proto/target.proto @@ -52,11 +52,10 @@ option java_package = "com.google.cloud.tasks.v2"; // The [AppEngineRouting][google.cloud.tasks.v2.AppEngineRouting] used to construct the URL that the task is // delivered to can be set at the queue-level or task-level: // -// * If set, -// [app_engine_routing_override][google.cloud.tasks.v2.AppEngineHttpQueue.app_engine_routing_override] -// is used for all tasks in the queue, no matter what the setting -// is for the -// [task-level app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing]. +// * If [app_engine_routing_override is set on the +// queue][Queue.app_engine_routing_override], this value is used for all +// tasks in the queue, no matter what the setting is for the [task-level +// app_engine_routing][AppEngineHttpRequest.app_engine_routing]. // // // The `url` that the task will be sent to is: @@ -79,7 +78,7 @@ option java_package = "com.google.cloud.tasks.v2"; // the app's handler returns a non-2xx response code or Cloud Tasks does // not receive response before the [deadline][google.cloud.tasks.v2.Task.dispatch_deadline]. Failed // tasks will be retried according to the -// [retry configuration][Queue.RetryConfig]. `503` (Service Unavailable) is +// [retry configuration][google.cloud.tasks.v2.Queue.retry_config]. `503` (Service Unavailable) is // considered an App Engine system error instead of an application error and // will cause Cloud Tasks' traffic congestion control to temporarily throttle // the queue's dispatches. Unlike other types of task targets, a `429` (Too Many @@ -101,10 +100,10 @@ message AppEngineHttpRequest { // Task-level setting for App Engine routing. // - // If set, - // [app_engine_routing_override][google.cloud.tasks.v2.AppEngineHttpQueue.app_engine_routing_override] - // is used for all tasks in the queue, no matter what the setting is for the - // [task-level app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing]. + // * If [app_engine_routing_override is set on the + // queue][Queue.app_engine_routing_override], this value is used for all + // tasks in the queue, no matter what the setting is for the [task-level + // app_engine_routing][AppEngineHttpRequest.app_engine_routing]. AppEngineRouting app_engine_routing = 2; // The relative URI. @@ -180,6 +179,13 @@ message AppEngineHttpRequest { // 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][google.cloud.tasks.v2.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` message AppEngineRouting { // App service. // diff --git a/tasks/google/cloud/tasks_v2/proto/target_pb2.py b/tasks/google/cloud/tasks_v2/proto/target_pb2.py index d9ebfb1a36be..0203f5333672 100644 --- a/tasks/google/cloud/tasks_v2/proto/target_pb2.py +++ b/tasks/google/cloud/tasks_v2/proto/target_pb2.py @@ -399,11 +399,11 @@ construct the URL that the task is delivered to can be set at the queue-level or task-level: - - If set, - [app\_engine\_routing\_override][google.cloud.tasks.v2.AppEngineHttpQueue.app\_engine\_routing\_override] - is used for all tasks in the queue, no matter what the setting is for - the [task-level - app\_engine\_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app\_engine\_routing]. + - If [app\_engine\_routing\_override is set on the + queue][Queue.app\_engine\_routing\_override], this value is used for + all tasks in the queue, no matter what the setting is for the + [task-level + app\_engine\_routing][AppEngineHttpRequest.app\_engine\_routing]. The ``url`` that the task will be sent to is: @@ -424,12 +424,13 @@ Tasks does not receive response before the [deadline][google.cloud.tasks.v2.Task.dispatch\_deadline]. Failed tasks will be retried according to the [retry - configuration][Queue.RetryConfig]. ``503`` (Service Unavailable) is - considered an App Engine system error instead of an application error - and will cause Cloud Tasks' traffic congestion control to temporarily - throttle 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. + configuration][google.cloud.tasks.v2.Queue.retry\_config]. ``503`` + (Service Unavailable) is considered an App Engine system error instead + of an application error and will cause Cloud Tasks' traffic congestion + control to temporarily throttle 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. Attributes: @@ -446,12 +447,12 @@ google.com/appengine/docs/python/tools/webapp/requesthandlercl ass>`_. app_engine_routing: - Task-level setting for App Engine routing. If set, [app\_engi - ne\_routing\_override][google.cloud.tasks.v2.AppEngineHttpQueu - e.app\_engine\_routing\_override] is used for all tasks in the - queue, no matter what the setting is for the [task-level app\_ - engine\_routing][google.cloud.tasks.v2.AppEngineHttpRequest.ap - p\_engine\_routing]. + Task-level setting for App Engine routing. - If + [app\_engine\_routing\_override is set on the + queue][Queue.app\_engine\_routing\_override], this value is + used for all tasks in the queue, no matter what the setting + is for the [task-level app\_engine\_routing][AppEngineHt + tpRequest.app\_engine\_routing]. relative_uri: The relative URI. The relative URI must begin with "/" and must be a valid HTTP relative URI. It can contain a path and @@ -526,6 +527,13 @@ and `App Engine Flex request routing `_. + Using [AppEngineRouting][google.cloud.tasks.v2.AppEngineRouting] + requires + ```appengine.applications.get`` `_ + Google IAM permission for the project and the following scope: + + ``https://www.googleapis.com/auth/cloud-platform`` + Attributes: service: diff --git a/tasks/google/cloud/tasks_v2/proto/task.proto b/tasks/google/cloud/tasks_v2/proto/task.proto index eefcb378c877..a555c2c19689 100644 --- a/tasks/google/cloud/tasks_v2/proto/task.proto +++ b/tasks/google/cloud/tasks_v2/proto/task.proto @@ -17,12 +17,12 @@ syntax = "proto3"; package google.cloud.tasks.v2; -import "google/api/annotations.proto"; import "google/api/resource.proto"; import "google/cloud/tasks/v2/target.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/timestamp.proto"; import "google/rpc/status.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks"; option java_multiple_files = true; @@ -31,6 +31,11 @@ option java_package = "com.google.cloud.tasks.v2"; // A unit of scheduled work. message Task { + option (google.api.resource) = { + type: "cloudtasks.googleapis.com/Task" + pattern: "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}" + }; + // The view specifies a subset of [Task][google.cloud.tasks.v2.Task] data. // // When a task is returned in a response, not all @@ -90,9 +95,7 @@ message Task { AppEngineHttpRequest app_engine_http_request = 2; } - // The time when the task is scheduled to be attempted. - // - // For App Engine queues, this is when the task will be attempted or retried. + // 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; diff --git a/tasks/google/cloud/tasks_v2/proto/task_pb2.py b/tasks/google/cloud/tasks_v2/proto/task_pb2.py index 374b1615a500..996e33c624ad 100644 --- a/tasks/google/cloud/tasks_v2/proto/task_pb2.py +++ b/tasks/google/cloud/tasks_v2/proto/task_pb2.py @@ -15,7 +15,6 @@ _sym_db = _symbol_database.Default() -from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2.proto import ( target_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2, @@ -23,6 +22,7 @@ from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2 +from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -33,15 +33,15 @@ "\n\031com.google.cloud.tasks.v2B\tTaskProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks" ), serialized_pb=_b( - '\n&google/cloud/tasks_v2/proto/task.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\x8e\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\x17\x61pp_engine_http_request\x18\x02 \x01(\x0b\x32+.google.cloud.tasks.v2.AppEngineHttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x07 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x08 \x01(\x05\x12\x35\n\rfirst_attempt\x18\t \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12\x34\n\x0clast_attempt\x18\n \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12.\n\x04view\x18\x0b \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02\x42\x0e\n\x0cmessage_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBd\n\x19\x63om.google.cloud.tasks.v2B\tTaskProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3' + '\n&google/cloud/tasks_v2/proto/task.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xf8\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\x17\x61pp_engine_http_request\x18\x02 \x01(\x0b\x32+.google.cloud.tasks.v2.AppEngineHttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x07 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x08 \x01(\x05\x12\x35\n\rfirst_attempt\x18\t \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12\x34\n\x0clast_attempt\x18\n \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12.\n\x04view\x18\x0b \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cmessage_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBd\n\x19\x63om.google.cloud.tasks.v2B\tTaskProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3' ), dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, google_dot_rpc_dot_status__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -265,7 +265,9 @@ extensions=[], nested_types=[], enum_types=[_TASK_VIEW], - serialized_options=None, + serialized_options=_b( + "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -279,7 +281,7 @@ ) ], serialized_start=255, - serialized_end=781, + serialized_end=887, ) @@ -371,8 +373,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=784, - serialized_end=991, + serialized_start=890, + serialized_end=1097, ) _TASK.fields_by_name[ @@ -452,8 +454,7 @@ App Engine task is a task that has [AppEngineHttpRequest][goog le.cloud.tasks.v2.AppEngineHttpRequest] set. schedule_time: - The time when the task is scheduled to be attempted. For App - Engine queues, this is when the task will be attempted or + The time when the task is scheduled to be attempted or retried. ``schedule_time`` will be truncated to the nearest microsecond. create_time: @@ -547,4 +548,5 @@ DESCRIPTOR._options = None +_TASK._options = None # @@protoc_insertion_point(module_scope) diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py b/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py index 344333202ef6..cdfdf40b3511 100644 --- a/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py +++ b/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py @@ -269,9 +269,7 @@ def list_queues( ... pass Args: - parent (str): Required. - - The location name. For example: + parent (str): Required. The location name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` filter_ (str): ``filter`` can be used to specify a subset of queues. Any ``Queue`` field can be used as a filter and several operators as supported. For @@ -372,9 +370,7 @@ def get_queue( >>> response = client.get_queue(name) Args: - name (str): Required. - - The resource name of the queue. For example: + name (str): Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -458,16 +454,12 @@ def create_queue( >>> response = client.create_queue(parent, queue) Args: - parent (str): Required. - - The location name in which the queue will be created. For example: - ``projects/PROJECT_ID/locations/LOCATION_ID`` + parent (str): Required. The location name in which the queue will be created. For + example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of allowed locations can be obtained by calling Cloud Tasks' implementation of ``ListLocations``. - queue (Union[dict, ~google.cloud.tasks_v2beta2.types.Queue]): Required. - - The queue to create. + queue (Union[dict, ~google.cloud.tasks_v2beta2.types.Queue]): Required. The queue to create. ``Queue's name`` cannot be the same as an existing queue. @@ -556,9 +548,7 @@ def update_queue( >>> response = client.update_queue(queue) Args: - queue (Union[dict, ~google.cloud.tasks_v2beta2.types.Queue]): Required. - - The queue to create or update. + queue (Union[dict, ~google.cloud.tasks_v2beta2.types.Queue]): Required. The queue to create or update. The queue's ``name`` must be specified. @@ -655,9 +645,7 @@ def delete_queue( >>> client.delete_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -729,9 +717,7 @@ def purge_queue( >>> response = client.purge_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -805,9 +791,7 @@ def pause_queue( >>> response = client.pause_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -886,9 +870,7 @@ def resume_queue( >>> response = client.resume_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -1241,9 +1223,7 @@ def list_tasks( ... pass Args: - parent (str): Required. - - The queue name. For example: + parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be returned. @@ -1346,9 +1326,7 @@ def get_task( >>> response = client.get_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be returned. @@ -1439,15 +1417,11 @@ def create_task( >>> response = client.create_task(parent, task) Args: - parent (str): Required. - - The queue name. For example: + parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` The queue must already exist. - task (Union[dict, ~google.cloud.tasks_v2beta2.types.Task]): Required. - - The task to add. + task (Union[dict, ~google.cloud.tasks_v2beta2.types.Task]): Required. The task to add. Task names have the following format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``. @@ -1565,9 +1539,7 @@ def delete_task( >>> client.delete_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -1654,11 +1626,16 @@ def lease_tasks( >>> response = client.lease_tasks(parent, lease_duration) Args: - parent (str): Required. - - The queue name. For example: + parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` - lease_duration (Union[dict, ~google.cloud.tasks_v2beta2.types.Duration]): After the worker has successfully finished the work associated with the + lease_duration (Union[dict, ~google.cloud.tasks_v2beta2.types.Duration]): Required. The duration of the lease. + + Each task returned in the ``response`` will have its ``schedule_time`` + set to the current time plus the ``lease_duration``. The task is leased + until its ``schedule_time``; thus, the task will not be returned to + another ``LeaseTasks`` call before its ``schedule_time``. + + After the worker has successfully finished the work associated with the task, the worker must call via ``AcknowledgeTask`` before the ``schedule_time``. Otherwise the task will be returned to a later ``LeaseTasks`` call so that another worker can retry it. @@ -1674,6 +1651,10 @@ def lease_tasks( ``max_tasks`` as possible. The largest that ``max_tasks`` can be is 1000. + + The maximum total size of a ``lease tasks response`` is 32 MB. If the + sum of all task sizes requested reaches this limit, fewer tasks than + requested are returned. response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be returned. @@ -1797,15 +1778,12 @@ def acknowledge_task( >>> client.acknowledge_task(name, schedule_time) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. - - The task's current schedule time, available in the ``schedule_time`` - returned by ``LeaseTasks`` response or ``RenewLease`` response. This - restriction is to ensure that your worker currently holds the lease. + schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. The task's current schedule time, available in the + ``schedule_time`` returned by ``LeaseTasks`` response or ``RenewLease`` + response. This restriction is to ensure that your worker currently holds + the lease. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2beta2.types.Timestamp` @@ -1889,21 +1867,16 @@ def renew_lease( >>> response = client.renew_lease(name, schedule_time, lease_duration) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. - - The task's current schedule time, available in the ``schedule_time`` - returned by ``LeaseTasks`` response or ``RenewLease`` response. This - restriction is to ensure that your worker currently holds the lease. + schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. The task's current schedule time, available in the + ``schedule_time`` returned by ``LeaseTasks`` response or ``RenewLease`` + response. This restriction is to ensure that your worker currently holds + the lease. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2beta2.types.Timestamp` - lease_duration (Union[dict, ~google.cloud.tasks_v2beta2.types.Duration]): Required. - - The desired new lease duration, starting from now. + lease_duration (Union[dict, ~google.cloud.tasks_v2beta2.types.Duration]): Required. The desired new lease duration, starting from now. The maximum lease duration is 1 week. ``lease_duration`` will be truncated to the nearest second. @@ -2003,15 +1976,12 @@ def cancel_lease( >>> response = client.cancel_lease(name, schedule_time) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. - - The task's current schedule time, available in the ``schedule_time`` - returned by ``LeaseTasks`` response or ``RenewLease`` response. This - restriction is to ensure that your worker currently holds the lease. + schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. The task's current schedule time, available in the + ``schedule_time`` returned by ``LeaseTasks`` response or ``RenewLease`` + response. This restriction is to ensure that your worker currently holds + the lease. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2beta2.types.Timestamp` @@ -2119,9 +2089,7 @@ def run_task( >>> response = client.run_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be returned. diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/enums.py b/tasks/google/cloud/tasks_v2beta2/gapic/enums.py index cd33b8c55800..c0860d328498 100644 --- a/tasks/google/cloud/tasks_v2beta2/gapic/enums.py +++ b/tasks/google/cloud/tasks_v2beta2/gapic/enums.py @@ -19,151 +19,6 @@ import enum -class Code(enum.IntEnum): - """ - The canonical error codes for Google APIs. - - Sometimes multiple error codes may apply. Services should return the - most specific error code that applies. For example, prefer - ``OUT_OF_RANGE`` over ``FAILED_PRECONDITION`` if both codes apply. - Similarly prefer ``NOT_FOUND`` or ``ALREADY_EXISTS`` over - ``FAILED_PRECONDITION``. - - Attributes: - OK (int): Not an error; returned on success - - HTTP Mapping: 200 OK - CANCELLED (int): The operation was cancelled, typically by the caller. - - HTTP Mapping: 499 Client Closed Request - UNKNOWN (int): Unknown error. For example, this error may be returned when a ``Status`` - value received from another address space belongs to an error space that - is not known in this address space. Also errors raised by APIs that do - not return enough error information may be converted to this error. - - HTTP Mapping: 500 Internal Server Error - INVALID_ARGUMENT (int): The client specified an invalid argument. Note that this differs from - ``FAILED_PRECONDITION``. ``INVALID_ARGUMENT`` indicates arguments that - are problematic regardless of the state of the system (e.g., a malformed - file name). - - HTTP Mapping: 400 Bad Request - DEADLINE_EXCEEDED (int): The deadline expired before the operation could complete. For operations - that change the state of the system, this error may be returned - even if the operation has completed successfully. For example, a - successful response from a server could have been delayed long - enough for the deadline to expire. - - HTTP Mapping: 504 Gateway Timeout - NOT_FOUND (int): Some requested entity (e.g., file or directory) was not found. - - Note to server developers: if a request is denied for an entire class of - users, such as gradual feature rollout or undocumented whitelist, - ``NOT_FOUND`` may be used. If a request is denied for some users within - a class of users, such as user-based access control, - ``PERMISSION_DENIED`` must be used. - - HTTP Mapping: 404 Not Found - ALREADY_EXISTS (int): The entity that a client attempted to create (e.g., file or directory) - already exists. - - HTTP Mapping: 409 Conflict - PERMISSION_DENIED (int): The caller does not have permission to execute the specified operation. - ``PERMISSION_DENIED`` must not be used for rejections caused by - exhausting some resource (use ``RESOURCE_EXHAUSTED`` instead for those - errors). ``PERMISSION_DENIED`` must not be used if the caller can not be - identified (use ``UNAUTHENTICATED`` instead for those errors). This - error code does not imply the request is valid or the requested entity - exists or satisfies other pre-conditions. - - HTTP Mapping: 403 Forbidden - UNAUTHENTICATED (int): The request does not have valid authentication credentials for the - operation. - - HTTP Mapping: 401 Unauthorized - RESOURCE_EXHAUSTED (int): Some resource has been exhausted, perhaps a per-user quota, or - perhaps the entire file system is out of space. - - HTTP Mapping: 429 Too Many Requests - FAILED_PRECONDITION (int): The operation was rejected because the system is not in a state required - for the operation's execution. For example, the directory to be deleted - is non-empty, an rmdir operation is applied to a non-directory, etc. - - Service implementors can use the following guidelines to decide between - ``FAILED_PRECONDITION``, ``ABORTED``, and ``UNAVAILABLE``: (a) Use - ``UNAVAILABLE`` if the client can retry just the failing call. (b) Use - ``ABORTED`` if the client should retry at a higher level (e.g., when a - client-specified test-and-set fails, indicating the client should - restart a read-modify-write sequence). (c) Use ``FAILED_PRECONDITION`` - if the client should not retry until the system state has been - explicitly fixed. E.g., if an "rmdir" fails because the directory is - non-empty, ``FAILED_PRECONDITION`` should be returned since the client - should not retry unless the files are deleted from the directory. - - HTTP Mapping: 400 Bad Request - ABORTED (int): The operation was aborted, typically due to a concurrency issue such as - a sequencer check failure or transaction abort. - - See the guidelines above for deciding between ``FAILED_PRECONDITION``, - ``ABORTED``, and ``UNAVAILABLE``. - - HTTP Mapping: 409 Conflict - OUT_OF_RANGE (int): The operation was attempted past the valid range. E.g., seeking or - reading past end-of-file. - - Unlike ``INVALID_ARGUMENT``, this error indicates a problem that may be - fixed if the system state changes. For example, a 32-bit file system - will generate ``INVALID_ARGUMENT`` if asked to read at an offset that is - not in the range [0,2^32-1], but it will generate ``OUT_OF_RANGE`` if - asked to read from an offset past the current file size. - - There is a fair bit of overlap between ``FAILED_PRECONDITION`` and - ``OUT_OF_RANGE``. We recommend using ``OUT_OF_RANGE`` (the more specific - error) when it applies so that callers who are iterating through a space - can easily look for an ``OUT_OF_RANGE`` error to detect when they are - done. - - HTTP Mapping: 400 Bad Request - UNIMPLEMENTED (int): The operation is not implemented or is not supported/enabled in this - service. - - HTTP Mapping: 501 Not Implemented - INTERNAL (int): Internal errors. This means that some invariants expected by the - underlying system have been broken. This error code is reserved - for serious errors. - - HTTP Mapping: 500 Internal Server Error - UNAVAILABLE (int): The service is currently unavailable. This is most likely a transient - condition, which can be corrected by retrying with a backoff. - - See the guidelines above for deciding between ``FAILED_PRECONDITION``, - ``ABORTED``, and ``UNAVAILABLE``. - - HTTP Mapping: 503 Service Unavailable - DATA_LOSS (int): Unrecoverable data loss or corruption. - - HTTP Mapping: 500 Internal Server Error - """ - - OK = 0 - CANCELLED = 1 - UNKNOWN = 2 - INVALID_ARGUMENT = 3 - DEADLINE_EXCEEDED = 4 - NOT_FOUND = 5 - ALREADY_EXISTS = 6 - PERMISSION_DENIED = 7 - UNAUTHENTICATED = 16 - RESOURCE_EXHAUSTED = 8 - FAILED_PRECONDITION = 9 - ABORTED = 10 - OUT_OF_RANGE = 11 - UNIMPLEMENTED = 12 - INTERNAL = 13 - UNAVAILABLE = 14 - DATA_LOSS = 15 - - class HttpMethod(enum.IntEnum): """ The HTTP method used to execute the task. diff --git a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks.proto b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks.proto index 61a6ecdc935d..79274fc37291 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks.proto +++ b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. +// syntax = "proto3"; package google.cloud.tasks.v2beta2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/tasks/v2beta2/queue.proto"; import "google/cloud/tasks/v2beta2/task.proto"; import "google/iam/v1/iam_policy.proto"; @@ -25,7 +29,6 @@ import "google/protobuf/duration.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/timestamp.proto"; -import "google/rpc/code.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks"; option java_multiple_files = true; @@ -36,6 +39,9 @@ option objc_class_prefix = "TASKS"; // Cloud Tasks allows developers to manage the execution of background // work in their applications. service CloudTasks { + option (google.api.default_host) = "cloudtasks.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Lists queues. // // Queues are returned in lexicographical order. @@ -43,6 +49,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta2/{parent=projects/*/locations/*}/queues" }; + option (google.api.method_signature) = "parent"; } // Gets a queue. @@ -50,13 +57,14 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta2/{name=projects/*/locations/*/queues/*}" }; + option (google.api.method_signature) = "name"; } // Creates a queue. // // Queues created with this method allow tasks to live for a maximum of 31 - // days. After a task is 31 days old, the task will be deleted regardless of - // whether it was dispatched or not. + // days. After a task is 31 days old, the task will be deleted regardless of whether + // it was dispatched or not. // // WARNING: Using this method may have unintended side effects if you are // using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. @@ -69,6 +77,7 @@ service CloudTasks { post: "/v2beta2/{parent=projects/*/locations/*}/queues" body: "queue" }; + option (google.api.method_signature) = "parent,queue"; } // Updates a queue. @@ -77,8 +86,8 @@ service CloudTasks { // the queue if it does exist. // // Queues created with this method allow tasks to live for a maximum of 31 - // days. After a task is 31 days old, the task will be deleted regardless of - // whether it was dispatched or not. + // days. After a task is 31 days old, the task will be deleted regardless of whether + // it was dispatched or not. // // WARNING: Using this method may have unintended side effects if you are // using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. @@ -91,6 +100,7 @@ service CloudTasks { patch: "/v2beta2/{queue.name=projects/*/locations/*/queues/*}" body: "queue" }; + option (google.api.method_signature) = "queue,update_mask"; } // Deletes a queue. @@ -110,6 +120,7 @@ service CloudTasks { option (google.api.http) = { delete: "/v2beta2/{name=projects/*/locations/*/queues/*}" }; + option (google.api.method_signature) = "name"; } // Purges a queue by deleting all of its tasks. @@ -123,32 +134,31 @@ service CloudTasks { post: "/v2beta2/{name=projects/*/locations/*/queues/*}:purge" body: "*" }; + option (google.api.method_signature) = "name"; } // Pauses the queue. // // If a queue is paused then the system will stop dispatching tasks // until the queue is resumed via - // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can - // still be added when the queue is paused. A queue is paused if its - // [state][google.cloud.tasks.v2beta2.Queue.state] is - // [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. + // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can still be added + // when the queue is paused. A queue is paused if its + // [state][google.cloud.tasks.v2beta2.Queue.state] is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. rpc PauseQueue(PauseQueueRequest) returns (Queue) { option (google.api.http) = { post: "/v2beta2/{name=projects/*/locations/*/queues/*}:pause" body: "*" }; + option (google.api.method_signature) = "name"; } // Resume a queue. // // This method resumes a queue after it has been // [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED] or - // [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a - // queue is stored in the queue's - // [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method - // it will be set to - // [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING]. + // [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a queue is stored + // in the queue's [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method it + // will be set to [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING]. // // WARNING: Resuming many high-QPS queues at the same time can // lead to target overloading. If you are resuming high-QPS @@ -160,27 +170,28 @@ service CloudTasks { post: "/v2beta2/{name=projects/*/locations/*/queues/*}:resume" body: "*" }; + option (google.api.method_signature) = "name"; } - // Gets the access control policy for a - // [Queue][google.cloud.tasks.v2beta2.Queue]. Returns an empty policy if the - // resource exists and does not have a policy set. + // Gets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue]. + // Returns an empty policy if the resource exists and does not have a policy + // set. // // Authorization requires the following // [Google IAM](https://cloud.google.com/iam) permission on the specified // resource parent: // // * `cloudtasks.queues.getIamPolicy` - rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) - returns (google.iam.v1.Policy) { + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { option (google.api.http) = { post: "/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource"; } - // Sets the access control policy for a - // [Queue][google.cloud.tasks.v2beta2.Queue]. Replaces any existing policy. + // Sets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue]. Replaces any existing + // policy. // // Note: The Cloud Console does not check queue-level IAM permissions yet. // Project-level permissions are required to use the Cloud Console. @@ -190,36 +201,35 @@ service CloudTasks { // resource parent: // // * `cloudtasks.queues.setIamPolicy` - rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) - returns (google.iam.v1.Policy) { + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { option (google.api.http) = { post: "/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource,policy"; } - // Returns permissions that a caller has on a - // [Queue][google.cloud.tasks.v2beta2.Queue]. If the resource does not exist, - // this will return an empty set of permissions, not a - // [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. + // Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta2.Queue]. + // If the resource does not exist, this will return an empty set of + // permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. // // Note: This operation is designed to be used for building permission-aware // UIs and command-line tools, not for authorization checking. This operation // may "fail open" without warning. - rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) - returns (google.iam.v1.TestIamPermissionsResponse) { + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) { option (google.api.http) = { post: "/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions" body: "*" }; + option (google.api.method_signature) = "resource,permissions"; } // Lists the tasks in a queue. // - // By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC] - // view is retrieved due to performance considerations; - // [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view] - // controls the subset of information which is returned. + // By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC] view is retrieved + // due to performance considerations; + // [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view] controls the + // subset of information which is returned. // // The tasks may be returned in any order. The ordering may change at any // time. @@ -227,6 +237,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks" }; + option (google.api.method_signature) = "parent"; } // Gets a task. @@ -234,22 +245,22 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}" }; + option (google.api.method_signature) = "name"; } // Creates a task and adds it to a queue. // // Tasks cannot be updated after creation; there is no UpdateTask command. // - // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], - // the maximum task size is + // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], the maximum task size is // 100KB. - // * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum - // task size is 1MB. + // * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum task size is 1MB. rpc CreateTask(CreateTaskRequest) returns (Task) { option (google.api.http) = { post: "/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks" body: "*" }; + option (google.api.method_signature) = "parent,task"; } // Deletes a task. @@ -261,6 +272,7 @@ service CloudTasks { option (google.api.http) = { delete: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}" }; + option (google.api.method_signature) = "name"; } // Leases tasks from a pull queue for @@ -268,19 +280,18 @@ service CloudTasks { // // This method is invoked by the worker to obtain a lease. The // worker must acknowledge the task via - // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] - // after they have performed the work associated with the task. - // - // The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended - // to store data that the worker needs to perform the work associated with the - // task. To return the payloads in the - // [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set - // [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view] - // to [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]. - // - // A maximum of 10 qps of - // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] requests are - // allowed per queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] + // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] after they have + // performed the work associated with the task. + // + // The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended to store data that + // the worker needs to perform the work associated with the task. To + // return the payloads in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set + // [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view] to + // [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]. + // + // A maximum of 10 qps of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] + // requests are allowed per + // queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] // is returned when this limit is // exceeded. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] // is also returned when @@ -291,18 +302,18 @@ service CloudTasks { post: "/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease" body: "*" }; + option (google.api.method_signature) = "parent,lease_duration"; } // Acknowledges a pull task. // // The worker, that is, the entity that - // [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must - // call this method to indicate that the work associated with the task has - // finished. + // [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must call this method + // to indicate that the work associated with the task has finished. // // The worker must acknowledge a task within the - // [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration] - // or the lease will expire and the task will become available to be leased + // [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration] or the lease + // will expire and the task will become available to be leased // again. After the task is acknowledged, it will not be returned // by a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks], // [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask], or @@ -312,85 +323,88 @@ service CloudTasks { post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge" body: "*" }; + option (google.api.method_signature) = "name,schedule_time"; } // Renew the current lease of a pull task. // // The worker can use this method to extend the lease by a new // duration, starting from now. The new task lease will be - // returned in the task's - // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. + // returned in the task's [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. rpc RenewLease(RenewLeaseRequest) returns (Task) { option (google.api.http) = { post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease" body: "*" }; + option (google.api.method_signature) = "name,schedule_time,lease_duration"; } // Cancel a pull task's lease. // // The worker can use this method to cancel a task's lease by - // setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] - // to now. This will make the task available to be leased to the next caller - // of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. + // setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] to now. This will + // make the task available to be leased to the next caller of + // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. rpc CancelLease(CancelLeaseRequest) returns (Task) { option (google.api.http) = { post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease" body: "*" }; + option (google.api.method_signature) = "name,schedule_time"; } // Forces a task to run now. // // When this method is called, Cloud Tasks will dispatch the task, even if - // the task is already running, the queue has reached its - // [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or is - // [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. + // the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or + // is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. // // This command is meant to be used for manual debugging. For - // example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be - // used to retry a failed task after a fix has been made or to manually force - // a task to be dispatched now. + // example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be used to retry a failed + // task after a fix has been made or to manually force a task to be + // dispatched now. // // The dispatched task is returned. That is, the task that is returned - // contains the [status][google.cloud.tasks.v2beta2.Task.status] after the - // task is dispatched but before the task is received by its target. + // contains the [status][google.cloud.tasks.v2beta2.Task.status] after the task is dispatched but + // before the task is received by its target. // // If Cloud Tasks receives a successful response from the task's // target, then the task will be deleted; otherwise the task's - // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be - // reset to the time that - // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus - // the retry delay specified in the queue's - // [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig]. + // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be reset to the time that + // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus the retry delay specified + // in the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig]. // // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] returns // [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a // task that has already succeeded or permanently failed. // - // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called - // on a [pull task][google.cloud.tasks.v2beta2.PullMessage]. + // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called on a + // [pull task][google.cloud.tasks.v2beta2.PullMessage]. rpc RunTask(RunTaskRequest) returns (Task) { option (google.api.http) = { post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run" body: "*" }; + option (google.api.method_signature) = "name"; } } -// Request message for -// [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]. +// Request message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]. message ListQueuesRequest { - // Required. - // - // The location name. + // Required. The location name. // For example: `projects/PROJECT_ID/locations/LOCATION_ID` - string parent = 1; - - // `filter` can be used to specify a subset of queues. Any - // [Queue][google.cloud.tasks.v2beta2.Queue] field can be used as a filter and - // several operators as supported. For example: `<=, <, >=, >, !=, =, :`. The - // filter syntax is the same as described in [Stackdriver's Advanced Logs + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "locations.googleapis.com/Location" + } + ]; + + // `filter` can be used to specify a subset of queues. Any [Queue][google.cloud.tasks.v2beta2.Queue] + // field can be used as a filter and several operators as supported. + // For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as + // described in + // [Stackdriver's Advanced Logs // Filters](https://cloud.google.com/logging/docs/view/advanced_filters). // // Sample filter "app_engine_http_target: *". @@ -404,25 +418,22 @@ message ListQueuesRequest { // The maximum page size is 9800. If unspecified, the page size will // be the maximum. Fewer queues than requested might be returned, // even if more queues exist; use the - // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token] - // in the response to determine if more queues exist. + // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token] in the + // response to determine if more queues exist. int32 page_size = 3; // A token identifying the page of results to return. // // To request the first page results, page_token must be empty. To // request the next page of results, page_token must be the value of - // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token] - // returned from the previous call to - // [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] method. It - // is an error to switch the value of the - // [filter][google.cloud.tasks.v2beta2.ListQueuesRequest.filter] while - // iterating through pages. + // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token] returned + // from the previous call to [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] + // method. It is an error to switch the value of the + // [filter][google.cloud.tasks.v2beta2.ListQueuesRequest.filter] while iterating through pages. string page_token = 4; } -// Response message for -// [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]. +// Response message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]. message ListQueuesResponse { // The list of queues. repeated Queue queues = 1; @@ -430,8 +441,7 @@ message ListQueuesResponse { // A token to retrieve next page of results. // // To return the next page of results, call - // [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] with this - // value as the + // [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] with this value as the // [page_token][google.cloud.tasks.v2beta2.ListQueuesRequest.page_token]. // // If the next_page_token is empty, there are no more results. @@ -440,53 +450,49 @@ message ListQueuesResponse { string next_page_token = 2; } -// Request message for -// [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue]. +// Request message for [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue]. message GetQueueRequest { - // Required. - // - // The resource name of the queue. For example: + // Required. The resource name of the queue. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } -// Request message for -// [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue]. +// Request message for [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue]. message CreateQueueRequest { - // Required. - // - // The location name in which the queue will be created. + // Required. The location name in which the queue will be created. // For example: `projects/PROJECT_ID/locations/LOCATION_ID` // // The list of allowed locations can be obtained by calling Cloud // Tasks' implementation of // [ListLocations][google.cloud.location.Locations.ListLocations]. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "locations.googleapis.com/Location" + } + ]; - // Required. + // Required. The queue to create. // - // The queue to create. - // - // [Queue's name][google.cloud.tasks.v2beta2.Queue.name] cannot be the same as - // an existing queue. - Queue queue = 2; + // [Queue's name][google.cloud.tasks.v2beta2.Queue.name] cannot be the same as an existing queue. + Queue queue = 2 [(google.api.field_behavior) = REQUIRED]; } -// Request message for -// [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue]. +// Request message for [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue]. message UpdateQueueRequest { - // Required. - // - // The queue to create or update. + // Required. The queue to create or update. // - // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] must be - // specified. + // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] must be specified. // // Output only fields cannot be modified using UpdateQueue. // Any value specified for an output only field will be ignored. - // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] cannot be - // changed. - Queue queue = 1; + // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] cannot be changed. + Queue queue = 1 [(google.api.field_behavior) = REQUIRED]; // A mask used to specify which fields of the queue are being updated. // @@ -494,93 +500,102 @@ message UpdateQueueRequest { google.protobuf.FieldMask update_mask = 2; } -// Request message for -// [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue]. +// Request message for [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue]. message DeleteQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } -// Request message for -// [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue]. +// Request message for [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue]. message PurgeQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } -// Request message for -// [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue]. +// Request message for [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue]. message PauseQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } -// Request message for -// [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. +// Request message for [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. message ResumeQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } -// Request message for listing tasks using -// [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. +// Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. message ListTasksRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string parent = 1; - - // The response_view specifies which subset of the - // [Task][google.cloud.tasks.v2beta2.Task] will be returned. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudtasks.googleapis.com/Queue" + } + ]; + + // 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. + // 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. + // 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. Task.View response_view = 2; - // Requested page size. Fewer tasks than requested might be returned. + // Maximum page size. // - // The maximum page size is 1000. If unspecified, the page size will - // be the maximum. Fewer tasks than requested might be returned, - // even if more tasks exist; use - // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token] - // in the response to determine if more tasks exist. + // Fewer tasks than requested might be returned, even if more tasks exist; use + // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.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. int32 page_size = 4; // A token identifying the page of results to return. // // To request the first page results, page_token must be empty. To // request the next page of results, page_token must be the value of - // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token] - // returned from the previous call to - // [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] method. + // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token] returned + // from the previous call to [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] + // method. // // The page token is valid for only 2 hours. string page_token = 5; } -// Response message for listing tasks using -// [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. +// Response message for listing tasks using [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. message ListTasksResponse { // The list of tasks. repeated Task tasks = 1; @@ -588,63 +603,63 @@ message ListTasksResponse { // A token to retrieve next page of results. // // To return the next page of results, call - // [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] with this - // value as the + // [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] with this value as the // [page_token][google.cloud.tasks.v2beta2.ListTasksRequest.page_token]. // // If the next_page_token is empty, there are no more results. string next_page_token = 2; } -// Request message for getting a task using -// [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask]. +// Request message for getting a task using [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask]. message GetTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; - - // The response_view specifies which subset of the - // [Task][google.cloud.tasks.v2beta2.Task] will be returned. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; + + // 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. + // 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. + // 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. Task.View response_view = 2; } -// Request message for -// [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. +// Request message for [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. message CreateTaskRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` // // The queue must already exist. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudtasks.googleapis.com/Queue" + } + ]; - // Required. - // - // The task to add. + // 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]. + // 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. + // 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: // @@ -659,50 +674,54 @@ message CreateTaskRequest { // for ~9days 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 + // 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. - Task task = 2; + Task task = 2 [(google.api.field_behavior) = REQUIRED]; - // The response_view specifies which subset of the - // [Task][google.cloud.tasks.v2beta2.Task] will be returned. + // 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. + // 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. + // 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. Task.View response_view = 3; } // Request message for deleting a task using // [DeleteTask][google.cloud.tasks.v2beta2.CloudTasks.DeleteTask]. message DeleteTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; } -// Request message for leasing tasks using -// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. +// Request message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. message LeaseTasksRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudtasks.googleapis.com/Queue" + } + ]; // The maximum number of tasks to lease. // @@ -710,47 +729,57 @@ message LeaseTasksRequest { // `max_tasks` as possible. // // The largest that `max_tasks` can be is 1000. + // + // The maximum total size of a [lease tasks response][google.cloud.tasks.v2beta2.LeaseTasksResponse] is + // 32 MB. If the sum of all task sizes requested reaches this limit, + // fewer tasks than requested are returned. int32 max_tasks = 2; + // Required. The duration of the lease. + // + // Each task returned in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will + // have its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] set to the current + // time plus the `lease_duration`. The task is leased until its + // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]; thus, the task will not be + // returned to another [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call + // before its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. + // // // After the worker has successfully finished the work associated // with the task, the worker must call via - // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] - // before the [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. - // Otherwise the task will be returned to a later - // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call so that - // another worker can retry it. + // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] before the + // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. Otherwise the task will be + // returned to a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call so + // that another worker can retry it. // // The maximum lease duration is 1 week. // `lease_duration` will be truncated to the nearest second. - google.protobuf.Duration lease_duration = 3; + google.protobuf.Duration lease_duration = 3 [(google.api.field_behavior) = REQUIRED]; - // The response_view specifies which subset of the - // [Task][google.cloud.tasks.v2beta2.Task] will be returned. + // 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. + // 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. + // 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. Task.View response_view = 4; // `filter` can be used to specify a subset of tasks to lease. // // When `filter` is set to `tag=` then the - // [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will contain only - // tasks whose [tag][google.cloud.tasks.v2beta2.PullMessage.tag] is equal to - // ``. `` must be less than 500 characters. + // [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will contain only tasks whose + // [tag][google.cloud.tasks.v2beta2.PullMessage.tag] is equal to ``. `` must be + // less than 500 characters. // // When `filter` is set to `tag_function=oldest_tag()`, only tasks which have // the same tag as the task with the oldest - // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be - // returned. + // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be returned. // // Grammar Syntax: // @@ -768,14 +797,12 @@ message LeaseTasksRequest { // [bytes](https://cloud.google.com/appengine/docs/standard/java/javadoc/com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), // only UTF-8 encoded tags can be used in Cloud Tasks. Tag which // aren't UTF-8 encoded can't be used in the - // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter] and the - // task's [tag][google.cloud.tasks.v2beta2.PullMessage.tag] will be displayed - // as empty in Cloud Tasks. + // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter] and the task's + // [tag][google.cloud.tasks.v2beta2.PullMessage.tag] will be displayed as empty in Cloud Tasks. string filter = 5; } -// Response message for leasing tasks using -// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. +// Response message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. message LeaseTasksResponse { // The leased tasks. repeated Task tasks = 1; @@ -784,120 +811,121 @@ message LeaseTasksResponse { // Request message for acknowledging a task using // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask]. message AcknowledgeTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; - - // Required. - // - // The task's current schedule time, available in the + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; + + // Required. The task's current schedule time, available in the // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] returned by // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or - // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. - // This restriction is to ensure that your worker currently holds the lease. - google.protobuf.Timestamp schedule_time = 2; + // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is + // to ensure that your worker currently holds the lease. + google.protobuf.Timestamp schedule_time = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for renewing a lease using // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease]. message RenewLeaseRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; - - // Required. - // - // The task's current schedule time, available in the + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; + + // Required. The task's current schedule time, available in the // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] returned by // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or - // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. - // This restriction is to ensure that your worker currently holds the lease. - google.protobuf.Timestamp schedule_time = 2; + // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is + // to ensure that your worker currently holds the lease. + google.protobuf.Timestamp schedule_time = 2 [(google.api.field_behavior) = REQUIRED]; - // Required. - // - // The desired new lease duration, starting from now. + // Required. The desired new lease duration, starting from now. // // // The maximum lease duration is 1 week. // `lease_duration` will be truncated to the nearest second. - google.protobuf.Duration lease_duration = 3; + google.protobuf.Duration lease_duration = 3 [(google.api.field_behavior) = REQUIRED]; - // The response_view specifies which subset of the - // [Task][google.cloud.tasks.v2beta2.Task] will be returned. + // 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. + // 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. + // 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. Task.View response_view = 4; } // Request message for canceling a lease using // [CancelLease][google.cloud.tasks.v2beta2.CloudTasks.CancelLease]. message CancelLeaseRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; - - // Required. - // - // The task's current schedule time, available in the + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; + + // Required. The task's current schedule time, available in the // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] returned by // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or - // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. - // This restriction is to ensure that your worker currently holds the lease. - google.protobuf.Timestamp schedule_time = 2; - - // 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. + // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is + // to ensure that your worker currently holds the lease. + google.protobuf.Timestamp schedule_time = 2 [(google.api.field_behavior) = REQUIRED]; + + // 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. Task.View response_view = 3; } // Request message for forcing a task to run now using // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask]. message RunTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; - - // The response_view specifies which subset of the - // [Task][google.cloud.tasks.v2beta2.Task] will be returned. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; + + // 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. + // 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. + // 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. Task.View response_view = 2; } diff --git a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py index 5db0340bd09f..b071f420cb7f 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py +++ b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py @@ -16,6 +16,9 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2beta2.proto import ( queue_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2, ) @@ -28,7 +31,6 @@ from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 -from google.rpc import code_pb2 as google_dot_rpc_dot_code__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -39,10 +41,13 @@ "\n\036com.google.cloud.tasks.v2beta2B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\242\002\005TASKS" ), serialized_pb=_b( - '\n1google/cloud/tasks_v2beta2/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a,google/cloud/tasks_v2beta2/proto/queue.proto\x1a+google/cloud/tasks_v2beta2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x15google/rpc/code.proto"Z\n\x11ListQueuesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1f\n\x0fGetQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"V\n\x12\x43reateQueueRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x30\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.Queue"w\n\x12UpdateQueueRequest\x12\x30\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.Queue\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask""\n\x12\x44\x65leteQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11PurgeQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11PauseQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t""\n\x12ResumeQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x87\x01\n\x10ListTasksRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\\\n\x0eGetTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\x91\x01\n\x11\x43reateTaskRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12.\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta2.Task\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"!\n\x11\x44\x65leteTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xb7\x01\n\x11LeaseTasksRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tmax_tasks\x18\x02 \x01(\x05\x12\x31\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t"E\n\x12LeaseTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task"Y\n\x16\x41\x63knowledgeTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x31\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xc5\x01\n\x11RenewLeaseRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x31\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\x93\x01\n\x12\x43\x61ncelLeaseRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x31\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\\\n\x0eRunTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View2\xf0\x19\n\nCloudTasks\x12\xa4\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta2.ListQueuesRequest\x1a..google.cloud.tasks.v2beta2.ListQueuesResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{parent=projects/*/locations/*}/queues\x12\x93\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta2.GetQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"7\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{name=projects/*/locations/*/queues/*}\x12\xa0\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta2.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue">\x82\xd3\xe4\x93\x02\x38"//v2beta2/{parent=projects/*/locations/*}/queues:\x05queue\x12\xa6\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta2.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"D\x82\xd3\xe4\x93\x02>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\x12\x8e\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty"7\x82\xd3\xe4\x93\x02\x31*//v2beta2/{name=projects/*/locations/*/queues/*}\x12\xa0\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta2.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"@\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\x01*\x12\xa0\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta2.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"@\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\x01*\x12\xa3\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta2.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"A\x82\xd3\xe4\x93\x02;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\x01*\x12\x96\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"K\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\x12\x96\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"K\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\x12\xbc\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"Q\x82\xd3\xe4\x93\x02K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\x12\xa9\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta2.ListTasksRequest\x1a-.google.cloud.tasks.v2beta2.ListTasksResponse"?\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\x12\x98\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta2.GetTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"?\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\x12\xa1\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta2.CreateTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"B\x82\xd3\xe4\x93\x02<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\x12\x94\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"?\x82\xd3\xe4\x93\x02\x39*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\x12\xb5\x01\n\nLeaseTasks\x12-.google.cloud.tasks.v2beta2.LeaseTasksRequest\x1a..google.cloud.tasks.v2beta2.LeaseTasksResponse"H\x82\xd3\xe4\x93\x02\x42"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\x01*\x12\xad\x01\n\x0f\x41\x63knowledgeTask\x12\x32.google.cloud.tasks.v2beta2.AcknowledgeTaskRequest\x1a\x16.google.protobuf.Empty"N\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\x01*\x12\xac\x01\n\nRenewLease\x12-.google.cloud.tasks.v2beta2.RenewLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"M\x82\xd3\xe4\x93\x02G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\x01*\x12\xaf\x01\n\x0b\x43\x61ncelLease\x12..google.cloud.tasks.v2beta2.CancelLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"N\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\x01*\x12\x9f\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta2.RunTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"F\x82\xd3\xe4\x93\x02@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*B|\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\xa2\x02\x05TASKSb\x06proto3' + '\n1google/cloud/tasks_v2beta2/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta2/proto/queue.proto\x1a+google/cloud/tasks_v2beta2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x85\x01\n\x11ListQueuesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x86\x01\n\x12\x43reateQueueRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xb0\x01\n\x10ListTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xbf\x01\n\x11\x43reateTaskRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta2.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\xe5\x01\n\x11LeaseTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x11\n\tmax_tasks\x18\x02 \x01(\x05\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t"E\n\x12LeaseTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task"\x86\x01\n\x16\x41\x63knowledgeTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02"\xf7\x01\n\x11RenewLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xc0\x01\n\x12\x43\x61ncelLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View2\xd4\x1c\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta2.ListQueuesRequest\x1a..google.cloud.tasks.v2beta2.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta2.GetQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta2.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta2.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta2.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta2.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta2.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta2.ListTasksRequest\x1a-.google.cloud.tasks.v2beta2.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta2.GetTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta2.CreateTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xcd\x01\n\nLeaseTasks\x12-.google.cloud.tasks.v2beta2.LeaseTasksRequest\x1a..google.cloud.tasks.v2beta2.LeaseTasksResponse"`\x82\xd3\xe4\x93\x02\x42"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\x01*\xda\x41\x15parent,lease_duration\x12\xc2\x01\n\x0f\x41\x63knowledgeTask\x12\x32.google.cloud.tasks.v2beta2.AcknowledgeTaskRequest\x1a\x16.google.protobuf.Empty"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\x01*\xda\x41\x12name,schedule_time\x12\xd0\x01\n\nRenewLease\x12-.google.cloud.tasks.v2beta2.RenewLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"q\x82\xd3\xe4\x93\x02G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\x01*\xda\x41!name,schedule_time,lease_duration\x12\xc4\x01\n\x0b\x43\x61ncelLease\x12..google.cloud.tasks.v2beta2.CancelLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\x01*\xda\x41\x12name,schedule_time\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta2.RunTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"M\x82\xd3\xe4\x93\x02@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\xa2\x02\x05TASKSb\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.DESCRIPTOR, google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR, @@ -51,7 +56,6 @@ google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_rpc_dot_code__pb2.DESCRIPTOR, ], ) @@ -78,7 +82,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!locations.googleapis.com/Location" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -144,8 +150,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=413, - serialized_end=503, + serialized_start=476, + serialized_end=609, ) @@ -201,8 +207,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=505, - serialized_end=601, + serialized_start=611, + serialized_end=707, ) @@ -228,7 +234,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -240,8 +248,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=603, - serialized_end=634, + serialized_start=709, + serialized_end=781, ) @@ -267,7 +275,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!locations.googleapis.com/Location" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -285,7 +295,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -297,8 +307,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=636, - serialized_end=722, + serialized_start=784, + serialized_end=918, ) @@ -324,7 +334,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -354,8 +364,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=724, - serialized_end=843, + serialized_start=920, + serialized_end=1044, ) @@ -381,7 +391,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -393,8 +405,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=845, - serialized_end=879, + serialized_start=1046, + serialized_end=1121, ) @@ -420,7 +432,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -432,8 +446,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=881, - serialized_end=914, + serialized_start=1123, + serialized_end=1197, ) @@ -459,7 +473,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -471,8 +487,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=916, - serialized_end=949, + serialized_start=1199, + serialized_end=1273, ) @@ -498,7 +514,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -510,8 +528,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=951, - serialized_end=985, + serialized_start=1275, + serialized_end=1350, ) @@ -537,7 +555,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -603,8 +623,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=988, - serialized_end=1123, + serialized_start=1353, + serialized_end=1529, ) @@ -660,8 +680,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1125, - serialized_end=1218, + serialized_start=1531, + serialized_end=1624, ) @@ -687,7 +707,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -717,8 +739,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1220, - serialized_end=1312, + serialized_start=1627, + serialized_end=1759, ) @@ -744,7 +766,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -762,7 +786,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -792,8 +816,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1315, - serialized_end=1460, + serialized_start=1762, + serialized_end=1953, ) @@ -819,7 +843,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ) ], @@ -831,8 +857,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1462, - serialized_end=1495, + serialized_start=1955, + serialized_end=2028, ) @@ -858,7 +884,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -894,7 +922,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -942,8 +970,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1498, - serialized_end=1681, + serialized_start=2031, + serialized_end=2260, ) @@ -981,8 +1009,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1683, - serialized_end=1752, + serialized_start=2262, + serialized_end=2331, ) @@ -1008,7 +1036,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1026,7 +1056,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -1038,8 +1068,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1754, - serialized_end=1843, + serialized_start=2334, + serialized_end=2468, ) @@ -1065,7 +1095,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1083,7 +1115,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1101,7 +1133,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1131,8 +1163,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1846, - serialized_end=2043, + serialized_start=2471, + serialized_end=2718, ) @@ -1158,7 +1190,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1176,7 +1210,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1206,8 +1240,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=2046, - serialized_end=2193, + serialized_start=2721, + serialized_end=2913, ) @@ -1233,7 +1267,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1263,8 +1299,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=2195, - serialized_end=2287, + serialized_start=2916, + serialized_end=3048, ) _LISTQUEUESRESPONSE.fields_by_name[ @@ -1358,7 +1394,7 @@ Attributes: parent: - Required. The location name. For example: + Required. The location name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` filter: ``filter`` can be used to specify a subset of queues. Any @@ -1432,7 +1468,7 @@ Attributes: name: - Required. The resource name of the queue. For example: + Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.GetQueueRequest) @@ -1452,14 +1488,14 @@ Attributes: parent: - Required. The location name in which the queue will be + Required. The location name in which the queue will be created. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of allowed locations can be obtained by calling Cloud Tasks' implementation of [ListLocations][google.cloud.location.Locati ons.ListLocations]. queue: - Required. The queue to create. [Queue's + Required. The queue to create. [Queue's name][google.cloud.tasks.v2beta2.Queue.name] cannot be the same as an existing queue. """, @@ -1480,7 +1516,7 @@ Attributes: queue: - Required. The queue to create or update. The queue's + Required. The queue to create or update. The queue's [name][google.cloud.tasks.v2beta2.Queue.name] must be specified. Output only fields cannot be modified using UpdateQueue. Any value specified for an output only field will @@ -1508,7 +1544,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.DeleteQueueRequest) @@ -1528,7 +1564,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PurgeQueueRequest) @@ -1548,7 +1584,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PauseQueueRequest) @@ -1568,7 +1604,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ResumeQueueRequest) @@ -1588,7 +1624,7 @@ Attributes: parent: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view: The response\_view specifies which subset of the @@ -1604,12 +1640,12 @@ `_ permission on the [Task][google.cloud.tasks.v2beta2.Task] resource. page_size: - Requested page size. Fewer tasks than requested might be - returned. The maximum page size is 1000. If unspecified, the - page size will be the maximum. Fewer tasks than requested - might be returned, even if more tasks exist; use [next\_page\_ - token][google.cloud.tasks.v2beta2.ListTasksResponse.next\_page - \_token] in the response to determine if more tasks exist. + Maximum page size. Fewer tasks than requested might be + returned, even if more tasks exist; use [next\_page\_token][go + ogle.cloud.tasks.v2beta2.ListTasksResponse.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. page_token: A token identifying the page of results to return. To request the first page results, page\_token must be empty. To request @@ -1662,8 +1698,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: The response\_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By @@ -1695,11 +1731,11 @@ Attributes: parent: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` The queue must already exist. task: - Required. The task to add. Task names have the following + Required. The task to add. Task names have the following format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUE UE_ID/tasks/TASK_ID``. The user can optionally specify a task [name][google.cloud.tasks.v2beta2.Task.name]. If a name is not @@ -1759,8 +1795,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.DeleteTaskRequest) ), @@ -1779,18 +1815,32 @@ Attributes: parent: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` max_tasks: The maximum number of tasks to lease. The system will make a best effort to return as close to as ``max_tasks`` as - possible. The largest that ``max_tasks`` can be is 1000. + possible. The largest that ``max_tasks`` can be is 1000. The + maximum total size of a [lease tasks + response][google.cloud.tasks.v2beta2.LeaseTasksResponse] is 32 + MB. If the sum of all task sizes requested reaches this limit, + fewer tasks than requested are returned. lease_duration: - After the worker has successfully finished the work associated - with the task, the worker must call via [AcknowledgeTask][goog - le.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] before the - [schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_tim - e]. Otherwise the task will be returned to a later + Required. The duration of the lease. Each task returned in + the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] + will have its [schedule\_time][google.cloud.tasks.v2beta2.Task + .schedule\_time] set to the current time plus the + ``lease_duration``. The task is leased until its [schedule\_ti + me][google.cloud.tasks.v2beta2.Task.schedule\_time]; thus, the + task will not be returned to another + [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] + call before its [schedule\_time][google.cloud.tasks.v2beta2.Ta + sk.schedule\_time]. After the worker has successfully + finished the work associated with the task, the worker must + call via [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTas + ks.AcknowledgeTask] before the [schedule\_time][google.cloud.t + asks.v2beta2.Task.schedule\_time]. Otherwise the task will be + returned to a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call so that another worker can retry it. The maximum lease duration is 1 week. ``lease_duration`` will be truncated to @@ -1869,12 +1919,12 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` schedule_time: - Required. The task's current schedule time, available in the - [schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_tim - e] returned by + Required. The task's current schedule time, available in the [ + schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time + ] returned by [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] @@ -1898,19 +1948,19 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` schedule_time: - Required. The task's current schedule time, available in the - [schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_tim - e] returned by + Required. The task's current schedule time, available in the [ + schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time + ] returned by [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is to ensure that your worker currently holds the lease. lease_duration: - Required. The desired new lease duration, starting from now. + Required. The desired new lease duration, starting from now. The maximum lease duration is 1 week. ``lease_duration`` will be truncated to the nearest second. response_view: @@ -1944,12 +1994,12 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` schedule_time: - Required. The task's current schedule time, available in the - [schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_tim - e] returned by + Required. The task's current schedule time, available in the [ + schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time + ] returned by [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] @@ -1986,8 +2036,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: The response\_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By @@ -2009,15 +2059,41 @@ DESCRIPTOR._options = None +_LISTQUEUESREQUEST.fields_by_name["parent"]._options = None +_GETQUEUEREQUEST.fields_by_name["name"]._options = None +_CREATEQUEUEREQUEST.fields_by_name["parent"]._options = None +_CREATEQUEUEREQUEST.fields_by_name["queue"]._options = None +_UPDATEQUEUEREQUEST.fields_by_name["queue"]._options = None +_DELETEQUEUEREQUEST.fields_by_name["name"]._options = None +_PURGEQUEUEREQUEST.fields_by_name["name"]._options = None +_PAUSEQUEUEREQUEST.fields_by_name["name"]._options = None +_RESUMEQUEUEREQUEST.fields_by_name["name"]._options = None +_LISTTASKSREQUEST.fields_by_name["parent"]._options = None +_GETTASKREQUEST.fields_by_name["name"]._options = None +_CREATETASKREQUEST.fields_by_name["parent"]._options = None +_CREATETASKREQUEST.fields_by_name["task"]._options = None +_DELETETASKREQUEST.fields_by_name["name"]._options = None +_LEASETASKSREQUEST.fields_by_name["parent"]._options = None +_LEASETASKSREQUEST.fields_by_name["lease_duration"]._options = None +_ACKNOWLEDGETASKREQUEST.fields_by_name["name"]._options = None +_ACKNOWLEDGETASKREQUEST.fields_by_name["schedule_time"]._options = None +_RENEWLEASEREQUEST.fields_by_name["name"]._options = None +_RENEWLEASEREQUEST.fields_by_name["schedule_time"]._options = None +_RENEWLEASEREQUEST.fields_by_name["lease_duration"]._options = None +_CANCELLEASEREQUEST.fields_by_name["name"]._options = None +_CANCELLEASEREQUEST.fields_by_name["schedule_time"]._options = None +_RUNTASKREQUEST.fields_by_name["name"]._options = None _CLOUDTASKS = _descriptor.ServiceDescriptor( name="CloudTasks", full_name="google.cloud.tasks.v2beta2.CloudTasks", file=DESCRIPTOR, index=0, - serialized_options=None, - serialized_start=2290, - serialized_end=5602, + serialized_options=_b( + "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" + ), + serialized_start=3051, + serialized_end=6719, methods=[ _descriptor.MethodDescriptor( name="ListQueues", @@ -2027,7 +2103,7 @@ input_type=_LISTQUEUESREQUEST, output_type=_LISTQUEUESRESPONSE, serialized_options=_b( - "\202\323\344\223\0021\022//v2beta2/{parent=projects/*/locations/*}/queues" + "\202\323\344\223\0021\022//v2beta2/{parent=projects/*/locations/*}/queues\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -2038,7 +2114,7 @@ input_type=_GETQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - "\202\323\344\223\0021\022//v2beta2/{name=projects/*/locations/*/queues/*}" + "\202\323\344\223\0021\022//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -2049,7 +2125,7 @@ input_type=_CREATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\0028"//v2beta2/{parent=projects/*/locations/*}/queues:\005queue' + '\202\323\344\223\0028"//v2beta2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue' ), ), _descriptor.MethodDescriptor( @@ -2060,7 +2136,7 @@ input_type=_UPDATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - "\202\323\344\223\002>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\005queue" + "\202\323\344\223\002>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask" ), ), _descriptor.MethodDescriptor( @@ -2071,7 +2147,7 @@ input_type=_DELETEQUEUEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\0021*//v2beta2/{name=projects/*/locations/*/queues/*}" + "\202\323\344\223\0021*//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -2082,7 +2158,7 @@ input_type=_PURGEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\001*' + '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -2093,7 +2169,7 @@ input_type=_PAUSEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\001*' + '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -2104,7 +2180,7 @@ input_type=_RESUMEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\002;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\001*' + '\202\323\344\223\002;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -2115,7 +2191,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, serialized_options=_b( - '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*' + '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource' ), ), _descriptor.MethodDescriptor( @@ -2126,7 +2202,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, serialized_options=_b( - '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*' + '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy' ), ), _descriptor.MethodDescriptor( @@ -2137,7 +2213,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, serialized_options=_b( - '\202\323\344\223\002K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*' + '\202\323\344\223\002K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions' ), ), _descriptor.MethodDescriptor( @@ -2148,7 +2224,7 @@ input_type=_LISTTASKSREQUEST, output_type=_LISTTASKSRESPONSE, serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks" + "\202\323\344\223\0029\0227/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -2159,7 +2235,7 @@ input_type=_GETTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}" + "\202\323\344\223\0029\0227/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -2170,7 +2246,7 @@ input_type=_CREATETASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\002<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\001*' + '\202\323\344\223\002<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task' ), ), _descriptor.MethodDescriptor( @@ -2181,7 +2257,7 @@ input_type=_DELETETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\0029*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}" + "\202\323\344\223\0029*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -2192,7 +2268,7 @@ input_type=_LEASETASKSREQUEST, output_type=_LEASETASKSRESPONSE, serialized_options=_b( - '\202\323\344\223\002B"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\001*' + '\202\323\344\223\002B"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\001*\332A\025parent,lease_duration' ), ), _descriptor.MethodDescriptor( @@ -2203,7 +2279,7 @@ input_type=_ACKNOWLEDGETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\001*' + '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\001*\332A\022name,schedule_time' ), ), _descriptor.MethodDescriptor( @@ -2214,7 +2290,7 @@ input_type=_RENEWLEASEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\002G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\001*' + '\202\323\344\223\002G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\001*\332A!name,schedule_time,lease_duration' ), ), _descriptor.MethodDescriptor( @@ -2225,7 +2301,7 @@ input_type=_CANCELLEASEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\001*' + '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\001*\332A\022name,schedule_time' ), ), _descriptor.MethodDescriptor( @@ -2236,7 +2312,7 @@ input_type=_RUNTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\002@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*' + '\202\323\344\223\002@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name' ), ), ], diff --git a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py index 0600b3209eb2..040424a35c9e 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py +++ b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py @@ -153,8 +153,8 @@ def CreateQueue(self, request, context): """Creates a queue. Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of - whether it was dispatched or not. + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. WARNING: Using this method may have unintended side effects if you are using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. @@ -174,8 +174,8 @@ def UpdateQueue(self, request, context): the queue if it does exist. Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of - whether it was dispatched or not. + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. WARNING: Using this method may have unintended side effects if you are using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. @@ -224,10 +224,9 @@ def PauseQueue(self, request, context): If a queue is paused then the system will stop dispatching tasks until the queue is resumed via - [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can - still be added when the queue is paused. A queue is paused if its - [state][google.cloud.tasks.v2beta2.Queue.state] is - [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. + [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can still be added + when the queue is paused. A queue is paused if its + [state][google.cloud.tasks.v2beta2.Queue.state] is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") @@ -238,11 +237,9 @@ def ResumeQueue(self, request, context): This method resumes a queue after it has been [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED] or - [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a - queue is stored in the queue's - [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method - it will be set to - [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING]. + [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a queue is stored + in the queue's [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method it + will be set to [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING]. WARNING: Resuming many high-QPS queues at the same time can lead to target overloading. If you are resuming high-QPS @@ -255,9 +252,9 @@ def ResumeQueue(self, request, context): raise NotImplementedError("Method not implemented!") def GetIamPolicy(self, request, context): - """Gets the access control policy for a - [Queue][google.cloud.tasks.v2beta2.Queue]. Returns an empty policy if the - resource exists and does not have a policy set. + """Gets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue]. + Returns an empty policy if the resource exists and does not have a policy + set. Authorization requires the following [Google IAM](https://cloud.google.com/iam) permission on the specified @@ -270,8 +267,8 @@ def GetIamPolicy(self, request, context): raise NotImplementedError("Method not implemented!") def SetIamPolicy(self, request, context): - """Sets the access control policy for a - [Queue][google.cloud.tasks.v2beta2.Queue]. Replaces any existing policy. + """Sets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue]. Replaces any existing + policy. Note: The Cloud Console does not check queue-level IAM permissions yet. Project-level permissions are required to use the Cloud Console. @@ -287,10 +284,9 @@ def SetIamPolicy(self, request, context): raise NotImplementedError("Method not implemented!") def TestIamPermissions(self, request, context): - """Returns permissions that a caller has on a - [Queue][google.cloud.tasks.v2beta2.Queue]. If the resource does not exist, - this will return an empty set of permissions, not a - [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. + """Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta2.Queue]. + If the resource does not exist, this will return an empty set of + permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation @@ -303,10 +299,10 @@ def TestIamPermissions(self, request, context): def ListTasks(self, request, context): """Lists the tasks in a queue. - By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC] - view is retrieved due to performance considerations; - [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view] - controls the subset of information which is returned. + By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC] view is retrieved + due to performance considerations; + [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view] controls the + subset of information which is returned. The tasks may be returned in any order. The ordering may change at any time. @@ -327,11 +323,9 @@ def CreateTask(self, request, context): Tasks cannot be updated after creation; there is no UpdateTask command. - * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], - the maximum task size is + * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], the maximum task size is 100KB. - * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum - task size is 1MB. + * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum task size is 1MB. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") @@ -354,19 +348,18 @@ def LeaseTasks(self, request, context): This method is invoked by the worker to obtain a lease. The worker must acknowledge the task via - [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] - after they have performed the work associated with the task. - - The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended - to store data that the worker needs to perform the work associated with the - task. To return the payloads in the - [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set - [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view] - to [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]. - - A maximum of 10 qps of - [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] requests are - allowed per queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] + [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] after they have + performed the work associated with the task. + + The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended to store data that + the worker needs to perform the work associated with the task. To + return the payloads in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set + [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view] to + [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]. + + A maximum of 10 qps of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] + requests are allowed per + queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] is returned when this limit is exceeded. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] is also returned when @@ -381,13 +374,12 @@ def AcknowledgeTask(self, request, context): """Acknowledges a pull task. The worker, that is, the entity that - [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must - call this method to indicate that the work associated with the task has - finished. + [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must call this method + to indicate that the work associated with the task has finished. The worker must acknowledge a task within the - [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration] - or the lease will expire and the task will become available to be leased + [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration] or the lease + will expire and the task will become available to be leased again. After the task is acknowledged, it will not be returned by a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks], [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask], or @@ -402,8 +394,7 @@ def RenewLease(self, request, context): The worker can use this method to extend the lease by a new duration, starting from now. The new task lease will be - returned in the task's - [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. + returned in the task's [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") @@ -413,9 +404,9 @@ def CancelLease(self, request, context): """Cancel a pull task's lease. The worker can use this method to cancel a task's lease by - setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] - to now. This will make the task available to be leased to the next caller - of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. + setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] to now. This will + make the task available to be leased to the next caller of + [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") @@ -425,33 +416,30 @@ def RunTask(self, request, context): """Forces a task to run now. When this method is called, Cloud Tasks will dispatch the task, even if - the task is already running, the queue has reached its - [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or is - [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. + the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or + is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. This command is meant to be used for manual debugging. For - example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be - used to retry a failed task after a fix has been made or to manually force - a task to be dispatched now. + example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be used to retry a failed + task after a fix has been made or to manually force a task to be + dispatched now. The dispatched task is returned. That is, the task that is returned - contains the [status][google.cloud.tasks.v2beta2.Task.status] after the - task is dispatched but before the task is received by its target. + contains the [status][google.cloud.tasks.v2beta2.Task.status] after the task is dispatched but + before the task is received by its target. If Cloud Tasks receives a successful response from the task's target, then the task will be deleted; otherwise the task's - [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be - reset to the time that - [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus - the retry delay specified in the queue's - [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig]. + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be reset to the time that + [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus the retry delay specified + in the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig]. [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] returns [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a task that has already succeeded or permanently failed. - [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called - on a [pull task][google.cloud.tasks.v2beta2.PullMessage]. + [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called on a + [pull task][google.cloud.tasks.v2beta2.PullMessage]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") diff --git a/tasks/google/cloud/tasks_v2beta2/proto/queue.proto b/tasks/google/cloud/tasks_v2beta2/proto/queue.proto index 3aa4b80b3a6a..212ab7384cc5 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/queue.proto +++ b/tasks/google/cloud/tasks_v2beta2/proto/queue.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,17 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. +// syntax = "proto3"; package google.cloud.tasks.v2beta2; -import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/tasks/v2beta2/target.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks"; option java_multiple_files = true; @@ -30,6 +32,11 @@ option java_package = "com.google.cloud.tasks.v2beta2"; // how those tasks are dispatched. Configurable properties include rate limits, // retry options, target types, and others. message Queue { + option (google.api.resource) = { + type: "cloudtasks.googleapis.com/Queue" + pattern: "projects/{project}/locations/{location}/queues/{queue}" + }; + // State of the queue. enum State { // Unspecified state. @@ -48,8 +55,8 @@ message Queue { // Tasks are paused by the user. If the queue is paused then Cloud // Tasks will stop delivering tasks from it, but more tasks can // still be added to it by the user. When a pull queue is paused, - // all [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls - // will return a [FAILED_PRECONDITION][google.rpc.Code.FAILED_PRECONDITION]. + // all [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls will return a + // [FAILED_PRECONDITION][google.rpc.Code.FAILED_PRECONDITION]. PAUSED = 2; // The queue is disabled. @@ -63,17 +70,16 @@ message Queue { // // When a queue is disabled, tasks can still be added to a queue // but the tasks are not dispatched and - // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls - // return a `FAILED_PRECONDITION` error. + // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls return a + // `FAILED_PRECONDITION` error. // // To permanently delete this queue and all of its tasks, call // [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue]. DISABLED = 3; } - // Caller-specified and required in - // [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue], after - // which it becomes output only. + // Caller-specified and required in [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue], + // after which it becomes output only. // // The queue name. // @@ -93,10 +99,9 @@ message Queue { // hyphens (-). The maximum length is 100 characters. string name = 1; - // Caller-specified and required in - // [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue][], after - // which the queue config type becomes output only, though fields within the - // config are mutable. + // Caller-specified and required in [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue][], + // after which the queue config type becomes output only, though fields within + // the config are mutable. // // The queue's target. // @@ -104,34 +109,30 @@ message Queue { oneof target_type { // App Engine HTTP target. // - // An App Engine queue is a queue that has an - // [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget]. + // An App Engine queue is a queue that has an [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget]. AppEngineHttpTarget app_engine_http_target = 3; // Pull target. // - // A pull queue is a queue that has a - // [PullTarget][google.cloud.tasks.v2beta2.PullTarget]. + // A pull queue is a queue that has a [PullTarget][google.cloud.tasks.v2beta2.PullTarget]. PullTarget pull_target = 4; } // Rate limits for task dispatches. // // [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] and - // [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] are related - // because they both control task attempts however they control how tasks are + // [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] are related because they both + // control task attempts however they control how tasks are // attempted in different ways: // - // * [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] controls the - // total rate of + // * [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] controls the total rate of // dispatches from a queue (i.e. all traffic dispatched from the // queue, regardless of whether the dispatch is from a first // attempt or a retry). - // * [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls - // what happens to + // * [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls what happens to // particular a task after its first attempt fails. That is, - // [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls - // task retries (the second attempt, third attempt, etc). + // [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls task retries (the + // second attempt, third attempt, etc). RateLimits rate_limits = 5; // Settings that determine the retry behavior. @@ -150,21 +151,18 @@ message Queue { // // `state` can only be changed by called // [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue], - // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue], or - // uploading + // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue], or uploading // [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref). - // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] cannot be - // used to change `state`. + // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] cannot be used to change `state`. State state = 7; // Output only. The last time this queue was purged. // - // All tasks that were [created][google.cloud.tasks.v2beta2.Task.create_time] - // before this time were purged. + // All tasks that were [created][google.cloud.tasks.v2beta2.Task.create_time] before this time + // were purged. // - // A queue can be purged using - // [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue], the [App - // Engine Task Queue SDK, or the Cloud + // A queue can be purged using [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue], the + // [App Engine Task Queue SDK, or the Cloud // Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). // // Purge time will be truncated to the nearest microsecond. Purge @@ -177,24 +175,19 @@ message Queue { // This message determines the maximum rate that tasks can be dispatched by a // queue, regardless of whether the dispatch is a first task attempt or a retry. // -// Note: The debugging command, -// [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask], will run a task -// even if the queue has reached its -// [RateLimits][google.cloud.tasks.v2beta2.RateLimits]. +// Note: The debugging command, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask], will run a task +// even if the queue has reached its [RateLimits][google.cloud.tasks.v2beta2.RateLimits]. message RateLimits { // The maximum rate at which tasks are dispatched from this queue. // // If unspecified when the queue is created, Cloud Tasks will pick the // default. // - // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], - // the maximum allowed value + // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], the maximum allowed value // is 500. - // * This field is output only for [pull - // queues][google.cloud.tasks.v2beta2.PullTarget]. In addition to the + // * This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. In addition to the // `max_tasks_dispatched_per_second` limit, a maximum of 10 QPS of - // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] requests - // are allowed per pull queue. + // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] requests are allowed per pull queue. // // // This field has the same meaning as @@ -227,9 +220,9 @@ message RateLimits { // `queue.yaml/xml`, `max_burst_size` is equal to // [bucket_size](https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size). // Since `max_burst_size` is output only, if - // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] is called - // on a queue created by `queue.yaml/xml`, `max_burst_size` will be reset - // based on the value of + // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] is called on a queue + // created by `queue.yaml/xml`, `max_burst_size` will be reset based + // on the value of // [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second], // regardless of whether // [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second] @@ -249,9 +242,8 @@ message RateLimits { // The maximum allowed value is 5,000. // // This field is output only for - // [pull queues][google.cloud.tasks.v2beta2.PullTarget] and always -1, which - // indicates no limit. No other queue types can have `max_concurrent_tasks` - // set to -1. + // [pull queues][google.cloud.tasks.v2beta2.PullTarget] and always -1, which indicates no limit. No other + // queue types can have `max_concurrent_tasks` set to -1. // // // This field has the same meaning as @@ -289,17 +281,16 @@ message RetryConfig { // If positive, `max_retry_duration` specifies the time limit for // retrying a failed task, measured from when the task was first // attempted. Once `max_retry_duration` time has passed *and* the - // task has been attempted - // [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] times, - // no further attempts will be made and the task will be deleted. + // task has been attempted [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] + // times, no further attempts will be made and the task will be + // deleted. // // If zero, then the task age is unlimited. // // If unspecified when the queue is created, Cloud Tasks will pick the // default. // - // This field is output only for [pull - // queues][google.cloud.tasks.v2beta2.PullTarget]. + // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. // // // `max_retry_duration` will be truncated to the nearest second. @@ -309,19 +300,16 @@ message RetryConfig { // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). google.protobuf.Duration max_retry_duration = 3; - // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] - // for retry between + // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] for retry between // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] and - // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration - // after it fails, if the queue's - // [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the - // task should be retried. + // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration after it fails, + // if the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the task should be + // retried. // // If unspecified when the queue is created, Cloud Tasks will pick the // default. // - // This field is output only for [pull - // queues][google.cloud.tasks.v2beta2.PullTarget]. + // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. // // // `min_backoff` will be truncated to the nearest second. @@ -331,19 +319,16 @@ message RetryConfig { // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). google.protobuf.Duration min_backoff = 4; - // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] - // for retry between + // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] for retry between // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] and - // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration - // after it fails, if the queue's - // [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the - // task should be retried. + // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration after it fails, + // if the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the task should be + // retried. // // If unspecified when the queue is created, Cloud Tasks will pick the // default. // - // This field is output only for [pull - // queues][google.cloud.tasks.v2beta2.PullTarget]. + // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. // // // `max_backoff` will be truncated to the nearest second. @@ -356,29 +341,26 @@ message RetryConfig { // The time between retries will double `max_doublings` times. // // A task's retry interval starts at - // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff], then - // doubles `max_doublings` times, then increases linearly, and finally retries - // retries at intervals of + // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff], then doubles + // `max_doublings` times, then increases linearly, and finally + // retries retries at intervals of // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] up to // [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] times. // - // For example, if - // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] is 10s, - // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] is 300s, - // and `max_doublings` is 3, then the a task will first be retried in 10s. The - // retry interval will double three times, and then increase linearly by 2^3 * - // 10s. Finally, the task will retry at intervals of - // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] until the - // task has been attempted - // [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] times. - // Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, - // 300s, .... + // For example, if [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] is 10s, + // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] is 300s, and + // `max_doublings` is 3, then the a task will first be retried in + // 10s. The retry interval will double three times, and then + // increase linearly by 2^3 * 10s. Finally, the task will retry at + // intervals of [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] until the + // task has been attempted [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] + // times. Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s, + // 240s, 300s, 300s, .... // // If unspecified when the queue is created, Cloud Tasks will pick the // default. // - // This field is output only for [pull - // queues][google.cloud.tasks.v2beta2.PullTarget]. + // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. // // // This field has the same meaning as diff --git a/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2.py index a866476a0aee..5fd3fd185df3 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2.py +++ b/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2.py @@ -15,12 +15,13 @@ _sym_db = _symbol_database.Default() -from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2beta2.proto import ( target_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2, ) from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 +from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -31,13 +32,14 @@ "\n\036com.google.cloud.tasks.v2beta2B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks" ), serialized_pb=_b( - '\n,google/cloud/tasks_v2beta2/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xe1\x03\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Q\n\x16\x61pp_engine_http_target\x18\x03 \x01(\x0b\x32/.google.cloud.tasks.v2beta2.AppEngineHttpTargetH\x00\x12=\n\x0bpull_target\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.PullTargetH\x00\x12;\n\x0brate_limits\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.RateLimits\x12=\n\x0cretry_config\x18\x06 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.RetryConfig\x12\x36\n\x05state\x18\x07 \x01(\x0e\x32\'.google.cloud.tasks.v2beta2.Queue.State\x12.\n\npurge_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03\x42\r\n\x0btarget_type"k\n\nRateLimits\x12\'\n\x1fmax_tasks_dispatched_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12\x1c\n\x14max_concurrent_tasks\x18\x03 \x01(\x05"\x81\x02\n\x0bRetryConfig\x12\x16\n\x0cmax_attempts\x18\x01 \x01(\x05H\x00\x12\x1c\n\x12unlimited_attempts\x18\x02 \x01(\x08H\x00\x12\x35\n\x12max_retry_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x06 \x01(\x05\x42\x0e\n\x0cnum_attemptsBo\n\x1e\x63om.google.cloud.tasks.v2beta2B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' + '\n,google/cloud/tasks_v2beta2/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xbf\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Q\n\x16\x61pp_engine_http_target\x18\x03 \x01(\x0b\x32/.google.cloud.tasks.v2beta2.AppEngineHttpTargetH\x00\x12=\n\x0bpull_target\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.PullTargetH\x00\x12;\n\x0brate_limits\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.RateLimits\x12=\n\x0cretry_config\x18\x06 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.RetryConfig\x12\x36\n\x05state\x18\x07 \x01(\x0e\x32\'.google.cloud.tasks.v2beta2.Queue.State\x12.\n\npurge_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\r\n\x0btarget_type"k\n\nRateLimits\x12\'\n\x1fmax_tasks_dispatched_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12\x1c\n\x14max_concurrent_tasks\x18\x03 \x01(\x05"\x81\x02\n\x0bRetryConfig\x12\x16\n\x0cmax_attempts\x18\x01 \x01(\x05H\x00\x12\x1c\n\x12unlimited_attempts\x18\x02 \x01(\x08H\x00\x12\x35\n\x12max_retry_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x06 \x01(\x05\x42\x0e\n\x0cnum_attemptsBo\n\x1e\x63om.google.cloud.tasks.v2beta2B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' ), dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -67,8 +69,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=616, - serialized_end=685, + serialized_start=643, + serialized_end=712, ) _sym_db.RegisterEnumDescriptor(_QUEUE_STATE) @@ -210,7 +212,9 @@ extensions=[], nested_types=[], enum_types=[_QUEUE_STATE], - serialized_options=None, + serialized_options=_b( + "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -223,8 +227,8 @@ fields=[], ) ], - serialized_start=219, - serialized_end=700, + serialized_start=246, + serialized_end=821, ) @@ -298,8 +302,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=702, - serialized_end=809, + serialized_start=823, + serialized_end=930, ) @@ -435,8 +439,8 @@ fields=[], ) ], - serialized_start=812, - serialized_end=1069, + serialized_start=933, + serialized_end=1190, ) _QUEUE.fields_by_name[ @@ -774,4 +778,5 @@ DESCRIPTOR._options = None +_QUEUE._options = None # @@protoc_insertion_point(module_scope) diff --git a/tasks/google/cloud/tasks_v2beta2/proto/target.proto b/tasks/google/cloud/tasks_v2beta2/proto/target.proto index ae1b5555dfd2..decdbaf8b791 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/target.proto +++ b/tasks/google/cloud/tasks_v2beta2/proto/target.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. +// syntax = "proto3"; package google.cloud.tasks.v2beta2; import "google/api/annotations.proto"; -import "google/protobuf/duration.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks"; option java_multiple_files = true; @@ -25,11 +25,12 @@ option java_outer_classname = "TargetProto"; option java_package = "com.google.cloud.tasks.v2beta2"; // Pull target. -message PullTarget {} +message PullTarget { + +} // The pull message contains data that can be used by the caller of -// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the -// task. +// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the task. // // This proto can only be used for tasks in a queue which has // [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] set. @@ -41,11 +42,10 @@ message PullMessage { // // Tags allow similar tasks to be processed in a batch. If you label // tasks with a tag, your worker can - // [lease tasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] with the - // same tag using - // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter]. For example, - // if you want to aggregate the events associated with a specific user once a - // day, you could tag tasks with the user ID. + // [lease tasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] with the same tag using + // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter]. For example, if you want to + // aggregate the events associated with a specific user once a day, + // you could tag tasks with the user ID. // // The task's tag can only be set when the // [task is created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. @@ -63,15 +63,11 @@ message PullMessage { // App Engine HTTP target. // // The task will be delivered to the App Engine application hostname -// specified by its -// [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] and -// [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]. The -// documentation for -// [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] -// explains how the task's host URL is constructed. +// specified by its [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] and [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]. +// The documentation for [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] explains how the +// task's host URL is constructed. // -// Using [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] -// requires +// Using [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] requires // [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control) // Google IAM permission for the project // and the following scope: @@ -79,13 +75,11 @@ message PullMessage { // `https://www.googleapis.com/auth/cloud-platform` message AppEngineHttpTarget { // Overrides for the - // [task-level - // app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. + // [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. // // If set, `app_engine_routing_override` is used for all tasks in // the queue, no matter what the setting is for the - // [task-level - // app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. + // [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. AppEngineRouting app_engine_routing_override = 1; } @@ -95,11 +89,9 @@ message AppEngineHttpTarget { // the task is dispatched. // // This proto can only be used for tasks in a queue which has -// [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target] -// set. +// [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target] set. // -// Using [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] -// requires +// Using [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] requires // [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control) // Google IAM permission for the project // and the following scope: @@ -113,17 +105,20 @@ message AppEngineHttpTarget { // and how routing is affected by // [dispatch // files](https://cloud.google.com/appengine/docs/python/config/dispatchref). +// Traffic is encrypted during transport and never leaves Google datacenters. +// Because this traffic is carried over a communication mechanism internal to +// Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS). +// The request to the handler, however, will appear to have used the HTTP +// protocol. // -// The [AppEngineRouting][google.cloud.tasks.v2beta2.AppEngineRouting] used to -// construct the URL that the task is delivered to can be set at the queue-level -// or task-level: +// The [AppEngineRouting][google.cloud.tasks.v2beta2.AppEngineRouting] used to construct the URL that the task is +// delivered to can be set at the queue-level or task-level: // // * If set, // [app_engine_routing_override][google.cloud.tasks.v2beta2.AppEngineHttpTarget.app_engine_routing_override] // is used for all tasks in the queue, no matter what the setting // is for the -// [task-level -// app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. +// [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. // // // The `url` that the task will be sent to is: @@ -131,13 +126,27 @@ message AppEngineHttpTarget { // * `url =` [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] `+` // [relative_url][google.cloud.tasks.v2beta2.AppEngineHttpRequest.relative_url] // -// The task attempt has succeeded if the app's request handler returns -// an HTTP response code in the range [`200` - `299`]. `503` is -// considered an App Engine system error instead of an application -// error. Requests returning error `503` will be retried regardless of -// retry configuration and not counted against retry counts. -// Any other response code or a failure to receive a response before the -// deadline is a failed attempt. +// Tasks can be dispatched to secure app handlers, unsecure app handlers, and +// URIs restricted with +// [`login: +// admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref). +// Because tasks are not run as any user, they cannot be dispatched to URIs +// restricted with +// [`login: +// required`](https://cloud.google.com/appengine/docs/standard/python/config/appref) +// Task dispatches also do not follow redirects. +// +// The task attempt has succeeded if the app's request handler returns an HTTP +// response code in the range [`200` - `299`]. The task attempt has failed if +// the app's handler returns a non-2xx response code or Cloud Tasks does +// not receive response before the [deadline][Task.dispatch_deadline]. Failed +// tasks will be retried according to the +// [retry configuration][google.cloud.tasks.v2beta2.Queue.retry_config]. `503` (Service Unavailable) is +// considered an App Engine system error instead of an application error and +// will cause Cloud Tasks' traffic congestion control to temporarily throttle +// 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. message AppEngineHttpRequest { // The HTTP method to use for the request. The default is POST. // @@ -157,8 +166,7 @@ message AppEngineHttpRequest { // If set, // [app_engine_routing_override][google.cloud.tasks.v2beta2.AppEngineHttpTarget.app_engine_routing_override] // is used for all tasks in the queue, no matter what the setting is for the - // [task-level - // app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. + // [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. AppEngineRouting app_engine_routing = 2; // The relative URL. @@ -184,8 +192,7 @@ message AppEngineHttpRequest { // `"AppEngine-Google; (+http://code.google.com/appengine)"` to the // modified `User-Agent`. // - // If the task has a - // [payload][google.cloud.tasks.v2beta2.AppEngineHttpRequest.payload], Cloud + // If the task has a [payload][google.cloud.tasks.v2beta2.AppEngineHttpRequest.payload], Cloud // Tasks sets the following headers: // // * `Content-Type`: By default, the `Content-Type` header is set to @@ -210,10 +217,8 @@ message AppEngineHttpRequest { // visible when the task is returned in a Cloud Tasks response. // // Although there is no specific limit for the maximum number of headers or - // the size, there is a limit on the maximum size of the - // [Task][google.cloud.tasks.v2beta2.Task]. For more information, see the - // [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask] - // documentation. + // the size, there is a limit on the maximum size of the [Task][google.cloud.tasks.v2beta2.Task]. For more + // information, see the [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask] documentation. map headers = 4; // Payload. @@ -227,6 +232,9 @@ message AppEngineHttpRequest { // 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), @@ -243,18 +251,16 @@ message AppEngineRouting { // service when the task is attempted. // // For some queues or tasks which were created using the App Engine - // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is - // not parsable into - // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], + // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable + // into [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.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][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable, - // then [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.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][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable, then + // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the - // empty string. + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the empty string. string service = 1; // App version. @@ -263,18 +269,16 @@ message AppEngineRouting { // version when the task is attempted. // // For some queues or tasks which were created using the App Engine - // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is - // not parsable into - // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], + // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable + // into [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.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][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable, - // then [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.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][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable, then + // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the - // empty string. + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the empty string. string version = 2; // App instance. @@ -315,49 +319,44 @@ message AppEngineRouting { // queue's project ID. Some tasks which were created using the App Engine // SDK use a custom domain name. // - // * `service =` - // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] + // * `service =` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] // - // * `version =` - // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] + // * `version =` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] // // * `version_dot_service =` // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] `+ '.' +` // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] // - // * `instance =` - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] + // * `instance =` [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] // // * `instance_dot_service =` - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' - // +` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' +` + // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] // // * `instance_dot_version =` - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' - // +` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' +` + // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] // // * `instance_dot_version_dot_service =` - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' - // +` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] `+ '.' - // +` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' +` + // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] `+ '.' +` + // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] // - // If [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] is empty, - // then the task will be sent to the service which is the default service when - // the task is attempted. + // If [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] is empty, then the task will be sent + // to the service which is the default service when the task is attempted. // - // If [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] is empty, - // then the task will be sent to the version which is the default version when - // the task is attempted. + // If [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] is empty, then the task will be sent + // to the version which is the default version when the task is attempted. // - // If [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is - // empty, then the task will be sent to an instance which is available when - // the task is attempted. + // If [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is empty, then the task + // will be sent to an instance which is available when the task is + // attempted. // // If [service][google.cloud.tasks.v2beta2.AppEngineRouting.service], // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], or - // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is - // invalid, then the task will be sent to the default version of the default - // service when the task is attempted. + // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is invalid, then the task + // will be sent to the default version of the default service when + // the task is attempted. string host = 4; } diff --git a/tasks/google/cloud/tasks_v2beta2/proto/target_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/target_pb2.py index 5ceaaeb5d492..85413eb533af 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/target_pb2.py +++ b/tasks/google/cloud/tasks_v2beta2/proto/target_pb2.py @@ -17,7 +17,6 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 -from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -28,12 +27,9 @@ "\n\036com.google.cloud.tasks.v2beta2B\013TargetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks" ), serialized_pb=_b( - '\n-google/cloud/tasks_v2beta2/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/protobuf/duration.proto"\x0c\n\nPullTarget"+\n\x0bPullMessage\x12\x0f\n\x07payload\x18\x01 \x01(\x0c\x12\x0b\n\x03tag\x18\x02 \x01(\t"h\n\x13\x41ppEngineHttpTarget\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting"\xc4\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta2.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting\x12\x14\n\x0crelative_url\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry\x12\x0f\n\x07payload\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t*[\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x42p\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' + '\n-google/cloud/tasks_v2beta2/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto"\x0c\n\nPullTarget"+\n\x0bPullMessage\x12\x0f\n\x07payload\x18\x01 \x01(\x0c\x12\x0b\n\x03tag\x18\x02 \x01(\t"h\n\x13\x41ppEngineHttpTarget\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting"\xc4\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta2.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting\x12\x14\n\x0crelative_url\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry\x12\x0f\n\x07payload\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t*[\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x42p\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' ), - dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, - google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, - ], + dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR], ) _HTTPMETHOD = _descriptor.EnumDescriptor( @@ -67,8 +63,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=717, - serialized_end=808, + serialized_start=685, + serialized_end=776, ) _sym_db.RegisterEnumDescriptor(_HTTPMETHOD) @@ -96,8 +92,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=139, - serialized_end=151, + serialized_start=107, + serialized_end=119, ) @@ -153,8 +149,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=153, - serialized_end=196, + serialized_start=121, + serialized_end=164, ) @@ -192,8 +188,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=198, - serialized_end=302, + serialized_start=166, + serialized_end=270, ) @@ -249,8 +245,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=583, - serialized_end=629, + serialized_start=551, + serialized_end=597, ) _APPENGINEHTTPREQUEST = _descriptor.Descriptor( @@ -359,8 +355,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=305, - serialized_end=629, + serialized_start=273, + serialized_end=597, ) @@ -452,8 +448,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=631, - serialized_end=715, + serialized_start=599, + serialized_end=683, ) _APPENGINEHTTPTARGET.fields_by_name[ @@ -605,6 +601,11 @@ Routed `_ and how routing is affected by `dispatch files `_. + Traffic is encrypted during transport and never leaves Google + datacenters. Because this traffic is carried over a communication + mechanism internal to Google, you cannot explicitly set the protocol + (for example, HTTP or HTTPS). The request to the handler, however, will + appear to have used the HTTP protocol. The [AppEngineRouting][google.cloud.tasks.v2beta2.AppEngineRouting] used to construct the URL that the task is delivered to can be set at the @@ -622,13 +623,27 @@ ``+`` [relative\_url][google.cloud.tasks.v2beta2.AppEngineHttpRequest.relative\_url] + Tasks can be dispatched to secure app handlers, unsecure app handlers, + and URIs restricted with + ```login: admin`` `_. + Because tasks are not run as any user, they cannot be dispatched to URIs + restricted with + ```login: required`` `_ + Task dispatches also do not follow redirects. + The task attempt has succeeded if the app's request handler returns an - HTTP response code in the range [``200`` - ``299``]. ``503`` is - considered an App Engine system error instead of an application error. - Requests returning error ``503`` will be retried regardless of retry - configuration and not counted against retry counts. Any other response - code or a failure to receive a response before the deadline is a failed - attempt. + HTTP response code in the range [``200`` - ``299``]. The task attempt + has failed if the app's handler returns a non-2xx response code or Cloud + Tasks does not receive response before the + [deadline][Task.dispatch\_deadline]. Failed tasks will be retried + according to the [retry + configuration][google.cloud.tasks.v2beta2.Queue.retry\_config]. ``503`` + (Service Unavailable) is considered an App Engine system error instead + of an application error and will cause Cloud Tasks' traffic congestion + control to temporarily throttle 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. Attributes: @@ -714,6 +729,9 @@ __module__="google.cloud.tasks_v2beta2.proto.target_pb2", __doc__="""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 `_, @@ -801,16 +819,15 @@ - ``instance =`` [instance][google.cloud.tasks.v2beta2.App EngineRouting.instance] - ``instance_dot_service =`` [ins tance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] - ``+ '.' +`` + ``+ '.' +`` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] - ``instance_dot_version =`` [instance][google.cloud.tasks - .v2beta2.AppEngineRouting.instance] ``+ '.' +`` + .v2beta2.AppEngineRouting.instance] ``+ '.' +`` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] - ``instance_dot_version_dot_service =`` [instance][google - .cloud.tasks.v2beta2.AppEngineRouting.instance] ``+ '.' - +`` + .cloud.tasks.v2beta2.AppEngineRouting.instance] ``+ '.' +`` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] - ``+ '.' +`` + ``+ '.' +`` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] If [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] diff --git a/tasks/google/cloud/tasks_v2beta2/proto/task.proto b/tasks/google/cloud/tasks_v2beta2/proto/task.proto index f9e18be492a5..9a927462c48c 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/task.proto +++ b/tasks/google/cloud/tasks_v2beta2/proto/task.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,17 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. +// syntax = "proto3"; package google.cloud.tasks.v2beta2; -import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/tasks/v2beta2/target.proto"; import "google/protobuf/timestamp.proto"; import "google/rpc/status.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks"; option java_multiple_files = true; @@ -28,8 +30,12 @@ option java_package = "com.google.cloud.tasks.v2beta2"; // A unit of scheduled work. message Task { - // The view specifies a subset of [Task][google.cloud.tasks.v2beta2.Task] - // data. + option (google.api.resource) = { + type: "cloudtasks.googleapis.com/Task" + pattern: "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}" + }; + + // The view specifies a subset of [Task][google.cloud.tasks.v2beta2.Task] data. // // When a task is returned in a response, not all // information is retrieved by default because some data, such as @@ -44,26 +50,22 @@ message Task { // sensitive data. // // This view does not include the - // ([payload in - // AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] - // and [payload in - // PullMessage][google.cloud.tasks.v2beta2.PullMessage.payload]). These - // payloads are desirable to return only when needed, because they can be - // large and because of the sensitivity of the data that you choose to store - // in it. + // ([payload in AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] and + // [payload in PullMessage][google.cloud.tasks.v2beta2.PullMessage.payload]). These payloads are + // desirable to return only when needed, because they can be large + // and because of the sensitivity of the data that you choose to + // store in it. BASIC = 1; // All information is returned. // - // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] - // requires `cloudtasks.tasks.fullView` [Google - // IAM](https://cloud.google.com/iam/) permission on the - // [Queue][google.cloud.tasks.v2beta2.Queue] resource. + // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires + // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/) + // permission on the [Queue][google.cloud.tasks.v2beta2.Queue] resource. FULL = 2; } - // Optionally caller-specified in - // [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. + // Optionally caller-specified in [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. // // The task name. // @@ -92,21 +94,16 @@ message Task { oneof payload_type { // App Engine HTTP request that is sent to the task's target. Can // be set only if - // [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target] - // is set on the queue. + // [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target] is set + // on the queue. // - // An App Engine task is a task that has - // [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] - // set. + // An App Engine task is a task that has [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] set. AppEngineHttpRequest app_engine_http_request = 3; - // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process - // the task. Can be set only if - // [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] is set on the - // queue. + // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the task. Can be + // set only if [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] is set on the queue. // - // A pull task is a task that has - // [PullMessage][google.cloud.tasks.v2beta2.PullMessage] set. + // A pull task is a task that has [PullMessage][google.cloud.tasks.v2beta2.PullMessage] set. PullMessage pull_message = 4; } @@ -117,8 +114,7 @@ message Task { // For pull queues, this is the time when the task is available to // be leased; if a task is currently leased, this is the time when // the current lease expires, that is, the time that the task was - // leased plus the - // [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration]. + // leased plus the [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration]. // // `schedule_time` will be truncated to the nearest microsecond. google.protobuf.Timestamp schedule_time = 5; @@ -131,8 +127,8 @@ message Task { // Output only. The task status. TaskStatus status = 7; - // Output only. The view specifies which subset of the - // [Task][google.cloud.tasks.v2beta2.Task] has been returned. + // Output only. The view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] has + // been returned. View view = 8; } @@ -140,32 +136,26 @@ message Task { message TaskStatus { // Output only. The number of attempts dispatched. // - // This count includes tasks which have been dispatched but haven't + // This count includes attempts which have been dispatched but haven't // received a response. int32 attempt_dispatch_count = 1; // Output only. The number of attempts which have received a response. // - // This field is not calculated for [pull - // tasks][google.cloud.tasks.v2beta2.PullMessage]. + // This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage]. int32 attempt_response_count = 2; // Output only. The status of the task's first attempt. // - // Only - // [dispatch_time][google.cloud.tasks.v2beta2.AttemptStatus.dispatch_time] - // will be set. The other - // [AttemptStatus][google.cloud.tasks.v2beta2.AttemptStatus] information is - // not retained by Cloud Tasks. + // Only [dispatch_time][google.cloud.tasks.v2beta2.AttemptStatus.dispatch_time] will be set. + // The other [AttemptStatus][google.cloud.tasks.v2beta2.AttemptStatus] information is not retained by Cloud Tasks. // - // This field is not calculated for [pull - // tasks][google.cloud.tasks.v2beta2.PullMessage]. + // This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage]. AttemptStatus first_attempt_status = 3; // Output only. The status of the task's last attempt. // - // This field is not calculated for [pull - // tasks][google.cloud.tasks.v2beta2.PullMessage]. + // This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage]. AttemptStatus last_attempt_status = 4; } diff --git a/tasks/google/cloud/tasks_v2beta2/proto/task_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/task_pb2.py index c596c1925daf..903dd9b190e7 100644 --- a/tasks/google/cloud/tasks_v2beta2/proto/task_pb2.py +++ b/tasks/google/cloud/tasks_v2beta2/proto/task_pb2.py @@ -15,12 +15,13 @@ _sym_db = _symbol_database.Default() -from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2beta2.proto import ( target_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2, ) from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2 +from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -31,13 +32,14 @@ "\n\036com.google.cloud.tasks.v2beta2B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks" ), serialized_pb=_b( - '\n+google/cloud/tasks_v2beta2/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xbe\x03\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta2.AppEngineHttpRequestH\x00\x12?\n\x0cpull_message\x18\x04 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.PullMessageH\x00\x12\x31\n\rschedule_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x06status\x18\x07 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.TaskStatus\x12\x33\n\x04view\x18\x08 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02\x42\x0e\n\x0cpayload_type"\xdd\x01\n\nTaskStatus\x12\x1e\n\x16\x61ttempt_dispatch_count\x18\x01 \x01(\x05\x12\x1e\n\x16\x61ttempt_response_count\x18\x02 \x01(\x05\x12G\n\x14\x66irst_attempt_status\x18\x03 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus\x12\x46\n\x13last_attempt_status\x18\x04 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus"\xd5\x01\n\rAttemptStatus\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta2B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' + '\n+google/cloud/tasks_v2beta2/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xa8\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta2.AppEngineHttpRequestH\x00\x12?\n\x0cpull_message\x18\x04 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.PullMessageH\x00\x12\x31\n\rschedule_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x06status\x18\x07 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.TaskStatus\x12\x33\n\x04view\x18\x08 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xdd\x01\n\nTaskStatus\x12\x1e\n\x16\x61ttempt_dispatch_count\x18\x01 \x01(\x05\x12\x1e\n\x16\x61ttempt_response_count\x18\x02 \x01(\x05\x12G\n\x14\x66irst_attempt_status\x18\x03 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus\x12\x46\n\x13last_attempt_status\x18\x04 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus"\xd5\x01\n\rAttemptStatus\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta2B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' ), dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, google_dot_rpc_dot_status__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -64,8 +66,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=592, - serialized_end=641, + serialized_start=619, + serialized_end=668, ) _sym_db.RegisterEnumDescriptor(_TASK_VIEW) @@ -207,7 +209,9 @@ extensions=[], nested_types=[], enum_types=[_TASK_VIEW], - serialized_options=None, + serialized_options=_b( + "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -220,8 +224,8 @@ fields=[], ) ], - serialized_start=211, - serialized_end=657, + serialized_start=238, + serialized_end=790, ) @@ -313,8 +317,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=660, - serialized_end=881, + serialized_start=793, + serialized_end=1014, ) @@ -406,8 +410,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=884, - serialized_end=1097, + serialized_start=1017, + serialized_end=1230, ) _TASK.fields_by_name[ @@ -540,8 +544,8 @@ Attributes: attempt_dispatch_count: Output only. The number of attempts dispatched. This count - includes tasks which have been dispatched but haven't received - a response. + includes attempts which have been dispatched but haven't + received a response. attempt_response_count: Output only. The number of attempts which have received a response. This field is not calculated for [pull @@ -598,4 +602,5 @@ DESCRIPTOR._options = None +_TASK._options = None # @@protoc_insertion_point(module_scope) diff --git a/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py b/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py index dd55e9e135f8..33a080ad7459 100644 --- a/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py +++ b/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py @@ -267,9 +267,7 @@ def list_queues( ... pass Args: - parent (str): Required. - - The location name. For example: + parent (str): Required. The location name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` filter_ (str): ``filter`` can be used to specify a subset of queues. Any ``Queue`` field can be used as a filter and several operators as supported. For @@ -370,9 +368,7 @@ def get_queue( >>> response = client.get_queue(name) Args: - name (str): Required. - - The resource name of the queue. For example: + name (str): Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -465,16 +461,12 @@ def create_queue( >>> response = client.create_queue(parent, queue) Args: - parent (str): Required. - - The location name in which the queue will be created. For example: - ``projects/PROJECT_ID/locations/LOCATION_ID`` + parent (str): Required. The location name in which the queue will be created. For + example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of allowed locations can be obtained by calling Cloud Tasks' implementation of ``ListLocations``. - queue (Union[dict, ~google.cloud.tasks_v2beta3.types.Queue]): Required. - - The queue to create. + queue (Union[dict, ~google.cloud.tasks_v2beta3.types.Queue]): Required. The queue to create. ``Queue's name`` cannot be the same as an existing queue. @@ -572,9 +564,7 @@ def update_queue( >>> response = client.update_queue(queue) Args: - queue (Union[dict, ~google.cloud.tasks_v2beta3.types.Queue]): Required. - - The queue to create or update. + queue (Union[dict, ~google.cloud.tasks_v2beta3.types.Queue]): Required. The queue to create or update. The queue's ``name`` must be specified. @@ -671,9 +661,7 @@ def delete_queue( >>> client.delete_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -745,9 +733,7 @@ def purge_queue( >>> response = client.purge_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -821,9 +807,7 @@ def pause_queue( >>> response = client.pause_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -902,9 +886,7 @@ def resume_queue( >>> response = client.resume_queue(name) Args: - name (str): Required. - - The queue name. For example: + name (str): Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -1257,9 +1239,7 @@ def list_tasks( ... pass Args: - parent (str): Required. - - The queue name. For example: + parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view (~google.cloud.tasks_v2beta3.types.View): The response\_view specifies which subset of the ``Task`` will be returned. @@ -1362,9 +1342,7 @@ def get_task( >>> response = client.get_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view (~google.cloud.tasks_v2beta3.types.View): The response\_view specifies which subset of the ``Task`` will be returned. @@ -1454,15 +1432,11 @@ def create_task( >>> response = client.create_task(parent, task) Args: - parent (str): Required. - - The queue name. For example: + parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` The queue must already exist. - task (Union[dict, ~google.cloud.tasks_v2beta3.types.Task]): Required. - - The task to add. + task (Union[dict, ~google.cloud.tasks_v2beta3.types.Task]): Required. The task to add. Task names have the following format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``. @@ -1580,9 +1554,7 @@ def delete_task( >>> client.delete_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -1670,9 +1642,7 @@ def run_task( >>> response = client.run_task(name) Args: - name (str): Required. - - The task name. For example: + name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view (~google.cloud.tasks_v2beta3.types.View): The response\_view specifies which subset of the ``Task`` will be returned. diff --git a/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks.proto b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks.proto index 66971c3e6b2f..431d5a73fc7a 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks.proto +++ b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks.proto @@ -18,6 +18,8 @@ syntax = "proto3"; package google.cloud.tasks.v2beta3; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/api/resource.proto"; import "google/cloud/tasks/v2beta3/queue.proto"; import "google/cloud/tasks/v2beta3/task.proto"; @@ -25,7 +27,6 @@ import "google/iam/v1/iam_policy.proto"; import "google/iam/v1/policy.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/rpc/code.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks"; option java_multiple_files = true; @@ -36,6 +37,9 @@ option objc_class_prefix = "TASKS"; // Cloud Tasks allows developers to manage the execution of background // work in their applications. service CloudTasks { + option (google.api.default_host) = "cloudtasks.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Lists queues. // // Queues are returned in lexicographical order. @@ -43,6 +47,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta3/{parent=projects/*/locations/*}/queues" }; + option (google.api.method_signature) = "parent"; } // Gets a queue. @@ -50,6 +55,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta3/{name=projects/*/locations/*/queues/*}" }; + option (google.api.method_signature) = "name"; } // Creates a queue. @@ -69,6 +75,7 @@ service CloudTasks { post: "/v2beta3/{parent=projects/*/locations/*}/queues" body: "queue" }; + option (google.api.method_signature) = "parent,queue"; } // Updates a queue. @@ -91,6 +98,7 @@ service CloudTasks { patch: "/v2beta3/{queue.name=projects/*/locations/*/queues/*}" body: "queue" }; + option (google.api.method_signature) = "queue,update_mask"; } // Deletes a queue. @@ -110,6 +118,7 @@ service CloudTasks { option (google.api.http) = { delete: "/v2beta3/{name=projects/*/locations/*/queues/*}" }; + option (google.api.method_signature) = "name"; } // Purges a queue by deleting all of its tasks. @@ -123,6 +132,7 @@ service CloudTasks { post: "/v2beta3/{name=projects/*/locations/*/queues/*}:purge" body: "*" }; + option (google.api.method_signature) = "name"; } // Pauses the queue. @@ -137,6 +147,7 @@ service CloudTasks { post: "/v2beta3/{name=projects/*/locations/*/queues/*}:pause" body: "*" }; + option (google.api.method_signature) = "name"; } // Resume a queue. @@ -157,6 +168,7 @@ service CloudTasks { post: "/v2beta3/{name=projects/*/locations/*/queues/*}:resume" body: "*" }; + option (google.api.method_signature) = "name"; } // Gets the access control policy for a [Queue][google.cloud.tasks.v2beta3.Queue]. @@ -173,6 +185,7 @@ service CloudTasks { post: "/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource"; } // Sets the access control policy for a [Queue][google.cloud.tasks.v2beta3.Queue]. Replaces any existing @@ -191,6 +204,7 @@ service CloudTasks { post: "/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource,policy"; } // Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta3.Queue]. @@ -205,6 +219,7 @@ service CloudTasks { post: "/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions" body: "*" }; + option (google.api.method_signature) = "resource,permissions"; } // Lists the tasks in a queue. @@ -220,6 +235,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks" }; + option (google.api.method_signature) = "parent"; } // Gets a task. @@ -227,6 +243,7 @@ service CloudTasks { option (google.api.http) = { get: "/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}" }; + option (google.api.method_signature) = "name"; } // Creates a task and adds it to a queue. @@ -239,6 +256,7 @@ service CloudTasks { post: "/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks" body: "*" }; + option (google.api.method_signature) = "parent,task"; } // Deletes a task. @@ -250,6 +268,7 @@ service CloudTasks { option (google.api.http) = { delete: "/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}" }; + option (google.api.method_signature) = "name"; } // Forces a task to run now. @@ -281,16 +300,20 @@ service CloudTasks { post: "/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run" body: "*" }; + option (google.api.method_signature) = "name"; } } // Request message for [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues]. message ListQueuesRequest { - // Required. - // - // The location name. + // Required. The location name. // For example: `projects/PROJECT_ID/locations/LOCATION_ID` - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "locations.googleapis.com/Location" + } + ]; // `filter` can be used to specify a subset of queues. Any [Queue][google.cloud.tasks.v2beta3.Queue] // field can be used as a filter and several operators as supported. @@ -344,45 +367,47 @@ message ListQueuesResponse { // Request message for [GetQueue][google.cloud.tasks.v2beta3.CloudTasks.GetQueue]. message GetQueueRequest { - // Required. - // - // The resource name of the queue. For example: + // Required. The resource name of the queue. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [CreateQueue][google.cloud.tasks.v2beta3.CloudTasks.CreateQueue]. message CreateQueueRequest { - // Required. - // - // The location name in which the queue will be created. + // Required. The location name in which the queue will be created. // For example: `projects/PROJECT_ID/locations/LOCATION_ID` // // The list of allowed locations can be obtained by calling Cloud // Tasks' implementation of // [ListLocations][google.cloud.location.Locations.ListLocations]. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "locations.googleapis.com/Location" + } + ]; - // Required. - // - // The queue to create. + // Required. The queue to create. // // [Queue's name][google.cloud.tasks.v2beta3.Queue.name] cannot be the same as an existing queue. - Queue queue = 2; + Queue queue = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue]. message UpdateQueueRequest { - // Required. - // - // The queue to create or update. + // Required. The queue to create or update. // // The queue's [name][google.cloud.tasks.v2beta3.Queue.name] must be specified. // // Output only fields cannot be modified using UpdateQueue. // Any value specified for an output only field will be ignored. // The queue's [name][google.cloud.tasks.v2beta3.Queue.name] cannot be changed. - Queue queue = 1; + Queue queue = 1 [(google.api.field_behavior) = REQUIRED]; // A mask used to specify which fields of the queue are being updated. // @@ -392,47 +417,62 @@ message UpdateQueueRequest { // Request message for [DeleteQueue][google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue]. message DeleteQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [PurgeQueue][google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue]. message PurgeQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [PauseQueue][google.cloud.tasks.v2beta3.CloudTasks.PauseQueue]. message PauseQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue]. message ResumeQueueRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Queue" + } + ]; } // Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks]. message ListTasksRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudtasks.googleapis.com/Queue" + } + ]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be // returned. @@ -487,11 +527,14 @@ message ListTasksResponse { // Request message for getting a task using [GetTask][google.cloud.tasks.v2beta3.CloudTasks.GetTask]. message GetTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be // returned. @@ -510,17 +553,18 @@ message GetTaskRequest { // Request message for [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]. message CreateTaskRequest { - // Required. - // - // The queue name. For example: + // Required. The queue name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` // // The queue must already exist. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudtasks.googleapis.com/Queue" + } + ]; - // Required. - // - // The task to add. + // Required. The task to add. // // Task names have the following format: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. @@ -553,7 +597,7 @@ message CreateTaskRequest { // task commands. The infrastructure relies on an approximately // uniform distribution of task ids to store and serve tasks // efficiently. - Task task = 2; + Task task = 2 [(google.api.field_behavior) = REQUIRED]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be // returned. @@ -573,21 +617,27 @@ message CreateTaskRequest { // Request message for deleting a task using // [DeleteTask][google.cloud.tasks.v2beta3.CloudTasks.DeleteTask]. message DeleteTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; } // Request message for forcing a task to run now using // [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask]. message RunTaskRequest { - // Required. - // - // The task name. For example: + // Required. The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudtasks.googleapis.com/Task" + } + ]; // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be // returned. diff --git a/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py index a9882bf4d211..45decbad7bfb 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py +++ b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py @@ -16,6 +16,8 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2beta3.proto import ( queue_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2, @@ -27,7 +29,6 @@ from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2 from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 -from google.rpc import code_pb2 as google_dot_rpc_dot_code__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -38,10 +39,12 @@ "\n\036com.google.cloud.tasks.v2beta3B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\242\002\005TASKS" ), serialized_pb=_b( - '\n1google/cloud/tasks_v2beta3/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta3/proto/queue.proto\x1a+google/cloud/tasks_v2beta3/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x15google/rpc/code.proto"Z\n\x11ListQueuesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta3.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1f\n\x0fGetQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"V\n\x12\x43reateQueueRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x30\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.Queue"w\n\x12UpdateQueueRequest\x12\x30\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.Queue\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask""\n\x12\x44\x65leteQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11PurgeQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11PauseQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t""\n\x12ResumeQueueRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x87\x01\n\x10ListTasksRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta3.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\\\n\x0eGetTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"\x91\x01\n\x11\x43reateTaskRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12.\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta3.Task\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"!\n\x11\x44\x65leteTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\\\n\x0eRunTaskRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View2\xa7\x14\n\nCloudTasks\x12\xa4\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta3.ListQueuesRequest\x1a..google.cloud.tasks.v2beta3.ListQueuesResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{parent=projects/*/locations/*}/queues\x12\x93\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta3.GetQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"7\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{name=projects/*/locations/*/queues/*}\x12\xa0\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta3.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue">\x82\xd3\xe4\x93\x02\x38"//v2beta3/{parent=projects/*/locations/*}/queues:\x05queue\x12\xa6\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta3.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"D\x82\xd3\xe4\x93\x02>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\x05queue\x12\x8e\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta3.DeleteQueueRequest\x1a\x16.google.protobuf.Empty"7\x82\xd3\xe4\x93\x02\x31*//v2beta3/{name=projects/*/locations/*/queues/*}\x12\xa0\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta3.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"@\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\x01*\x12\xa0\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta3.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"@\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\x01*\x12\xa3\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta3.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"A\x82\xd3\xe4\x93\x02;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\x01*\x12\x96\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"K\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\x12\x96\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"K\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\x12\xbc\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"Q\x82\xd3\xe4\x93\x02K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\x12\xa9\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta3.ListTasksRequest\x1a-.google.cloud.tasks.v2beta3.ListTasksResponse"?\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\x12\x98\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta3.GetTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"?\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\x12\xa1\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta3.CreateTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"B\x82\xd3\xe4\x93\x02<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\x12\x94\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta3.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"?\x82\xd3\xe4\x93\x02\x39*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\x12\x9f\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta3.RunTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"F\x82\xd3\xe4\x93\x02@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*B|\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\xa2\x02\x05TASKSb\x06proto3' + '\n1google/cloud/tasks_v2beta3/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta3/proto/queue.proto\x1a+google/cloud/tasks_v2beta3/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x85\x01\n\x11ListQueuesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta3.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x86\x01\n\x12\x43reateQueueRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xb0\x01\n\x10ListTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta3.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"\xbf\x01\n\x11\x43reateTaskRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta3.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View2\xa5\x16\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta3.ListQueuesRequest\x1a..google.cloud.tasks.v2beta3.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta3.GetQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta3.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta3/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta3.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta3.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta3.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta3.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta3.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta3.ListTasksRequest\x1a-.google.cloud.tasks.v2beta3.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta3.GetTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta3.CreateTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta3.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta3.RunTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"M\x82\xd3\xe4\x93\x02@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\xa2\x02\x05TASKSb\x06proto3' ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.DESCRIPTOR, @@ -49,7 +52,6 @@ google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, - google_dot_rpc_dot_code__pb2.DESCRIPTOR, ], ) @@ -76,7 +78,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!locations.googleapis.com/Location" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -142,8 +146,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=375, - serialized_end=465, + serialized_start=411, + serialized_end=544, ) @@ -199,8 +203,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=467, - serialized_end=563, + serialized_start=546, + serialized_end=642, ) @@ -226,7 +230,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -238,8 +244,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=565, - serialized_end=596, + serialized_start=644, + serialized_end=716, ) @@ -265,7 +271,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A#\022!locations.googleapis.com/Location" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -283,7 +291,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -295,8 +303,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=598, - serialized_end=684, + serialized_start=719, + serialized_end=853, ) @@ -322,7 +330,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -352,8 +360,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=686, - serialized_end=805, + serialized_start=855, + serialized_end=979, ) @@ -379,7 +387,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -391,8 +401,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=807, - serialized_end=841, + serialized_start=981, + serialized_end=1056, ) @@ -418,7 +428,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -430,8 +442,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=843, - serialized_end=876, + serialized_start=1058, + serialized_end=1132, ) @@ -457,7 +469,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -469,8 +483,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=878, - serialized_end=911, + serialized_start=1134, + serialized_end=1208, ) @@ -496,7 +510,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ) ], @@ -508,8 +524,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=913, - serialized_end=947, + serialized_start=1210, + serialized_end=1285, ) @@ -535,7 +551,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -601,8 +619,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=950, - serialized_end=1085, + serialized_start=1288, + serialized_end=1464, ) @@ -658,8 +676,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1087, - serialized_end=1180, + serialized_start=1466, + serialized_end=1559, ) @@ -685,7 +703,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -715,8 +735,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1182, - serialized_end=1274, + serialized_start=1562, + serialized_end=1694, ) @@ -742,7 +762,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -760,7 +782,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -790,8 +812,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1277, - serialized_end=1422, + serialized_start=1697, + serialized_end=1888, ) @@ -817,7 +839,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ) ], @@ -829,8 +853,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1424, - serialized_end=1457, + serialized_start=1890, + serialized_end=1963, ) @@ -856,7 +880,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=None, + serialized_options=_b( + "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -886,8 +912,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1459, - serialized_end=1551, + serialized_start=1966, + serialized_end=2098, ) _LISTQUEUESRESPONSE.fields_by_name[ @@ -949,7 +975,7 @@ Attributes: parent: - Required. The location name. For example: + Required. The location name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` filter: ``filter`` can be used to specify a subset of queues. Any @@ -1022,7 +1048,7 @@ Attributes: name: - Required. The resource name of the queue. For example: + Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.GetQueueRequest) @@ -1042,14 +1068,14 @@ Attributes: parent: - Required. The location name in which the queue will be + Required. The location name in which the queue will be created. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of allowed locations can be obtained by calling Cloud Tasks' implementation of [ListLocations][google.cloud.location.Locati ons.ListLocations]. queue: - Required. The queue to create. [Queue's + Required. The queue to create. [Queue's name][google.cloud.tasks.v2beta3.Queue.name] cannot be the same as an existing queue. """, @@ -1070,7 +1096,7 @@ Attributes: queue: - Required. The queue to create or update. The queue's + Required. The queue to create or update. The queue's [name][google.cloud.tasks.v2beta3.Queue.name] must be specified. Output only fields cannot be modified using UpdateQueue. Any value specified for an output only field will @@ -1098,7 +1124,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.DeleteQueueRequest) @@ -1118,7 +1144,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.PurgeQueueRequest) @@ -1138,7 +1164,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.PauseQueueRequest) @@ -1158,7 +1184,7 @@ Attributes: name: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ResumeQueueRequest) @@ -1178,7 +1204,7 @@ Attributes: parent: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view: The response\_view specifies which subset of the @@ -1252,8 +1278,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: The response\_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be returned. By @@ -1285,11 +1311,11 @@ Attributes: parent: - Required. The queue name. For example: + Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` The queue must already exist. task: - Required. The task to add. Task names have the following + Required. The task to add. Task names have the following format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUE UE_ID/tasks/TASK_ID``. The user can optionally specify a task [name][google.cloud.tasks.v2beta3.Task.name]. If a name is not @@ -1349,8 +1375,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.DeleteTaskRequest) ), @@ -1369,8 +1395,8 @@ Attributes: name: - Required. The task name. For example: ``projects/PROJECT_ID/l - ocations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` + Required. The task name. For example: ``projects/PROJECT_ID/lo + cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: The response\_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be returned. By @@ -1392,15 +1418,32 @@ DESCRIPTOR._options = None +_LISTQUEUESREQUEST.fields_by_name["parent"]._options = None +_GETQUEUEREQUEST.fields_by_name["name"]._options = None +_CREATEQUEUEREQUEST.fields_by_name["parent"]._options = None +_CREATEQUEUEREQUEST.fields_by_name["queue"]._options = None +_UPDATEQUEUEREQUEST.fields_by_name["queue"]._options = None +_DELETEQUEUEREQUEST.fields_by_name["name"]._options = None +_PURGEQUEUEREQUEST.fields_by_name["name"]._options = None +_PAUSEQUEUEREQUEST.fields_by_name["name"]._options = None +_RESUMEQUEUEREQUEST.fields_by_name["name"]._options = None +_LISTTASKSREQUEST.fields_by_name["parent"]._options = None +_GETTASKREQUEST.fields_by_name["name"]._options = None +_CREATETASKREQUEST.fields_by_name["parent"]._options = None +_CREATETASKREQUEST.fields_by_name["task"]._options = None +_DELETETASKREQUEST.fields_by_name["name"]._options = None +_RUNTASKREQUEST.fields_by_name["name"]._options = None _CLOUDTASKS = _descriptor.ServiceDescriptor( name="CloudTasks", full_name="google.cloud.tasks.v2beta3.CloudTasks", file=DESCRIPTOR, index=0, - serialized_options=None, - serialized_start=1554, - serialized_end=4153, + serialized_options=_b( + "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" + ), + serialized_start=2101, + serialized_end=4954, methods=[ _descriptor.MethodDescriptor( name="ListQueues", @@ -1410,7 +1453,7 @@ input_type=_LISTQUEUESREQUEST, output_type=_LISTQUEUESRESPONSE, serialized_options=_b( - "\202\323\344\223\0021\022//v2beta3/{parent=projects/*/locations/*}/queues" + "\202\323\344\223\0021\022//v2beta3/{parent=projects/*/locations/*}/queues\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -1421,7 +1464,7 @@ input_type=_GETQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - "\202\323\344\223\0021\022//v2beta3/{name=projects/*/locations/*/queues/*}" + "\202\323\344\223\0021\022//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1432,7 +1475,7 @@ input_type=_CREATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\0028"//v2beta3/{parent=projects/*/locations/*}/queues:\005queue' + '\202\323\344\223\0028"//v2beta3/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue' ), ), _descriptor.MethodDescriptor( @@ -1443,7 +1486,7 @@ input_type=_UPDATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - "\202\323\344\223\002>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\005queue" + "\202\323\344\223\002>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask" ), ), _descriptor.MethodDescriptor( @@ -1454,7 +1497,7 @@ input_type=_DELETEQUEUEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\0021*//v2beta3/{name=projects/*/locations/*/queues/*}" + "\202\323\344\223\0021*//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1465,7 +1508,7 @@ input_type=_PURGEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\001*' + '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1476,7 +1519,7 @@ input_type=_PAUSEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\001*' + '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1487,7 +1530,7 @@ input_type=_RESUMEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, serialized_options=_b( - '\202\323\344\223\002;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\001*' + '\202\323\344\223\002;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name' ), ), _descriptor.MethodDescriptor( @@ -1498,7 +1541,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, serialized_options=_b( - '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*' + '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource' ), ), _descriptor.MethodDescriptor( @@ -1509,7 +1552,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, serialized_options=_b( - '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*' + '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy' ), ), _descriptor.MethodDescriptor( @@ -1520,7 +1563,7 @@ input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, serialized_options=_b( - '\202\323\344\223\002K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*' + '\202\323\344\223\002K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions' ), ), _descriptor.MethodDescriptor( @@ -1531,7 +1574,7 @@ input_type=_LISTTASKSREQUEST, output_type=_LISTTASKSRESPONSE, serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks" + "\202\323\344\223\0029\0227/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent" ), ), _descriptor.MethodDescriptor( @@ -1542,7 +1585,7 @@ input_type=_GETTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}" + "\202\323\344\223\0029\0227/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1553,7 +1596,7 @@ input_type=_CREATETASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\002<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\001*' + '\202\323\344\223\002<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task' ), ), _descriptor.MethodDescriptor( @@ -1564,7 +1607,7 @@ input_type=_DELETETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, serialized_options=_b( - "\202\323\344\223\0029*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}" + "\202\323\344\223\0029*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" ), ), _descriptor.MethodDescriptor( @@ -1575,7 +1618,7 @@ input_type=_RUNTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK, serialized_options=_b( - '\202\323\344\223\002@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*' + '\202\323\344\223\002@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name' ), ), ], diff --git a/tasks/google/cloud/tasks_v2beta3/proto/queue.proto b/tasks/google/cloud/tasks_v2beta3/proto/queue.proto index 264a19eed4fe..777e9b8b4768 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/queue.proto +++ b/tasks/google/cloud/tasks_v2beta3/proto/queue.proto @@ -17,11 +17,11 @@ syntax = "proto3"; package google.cloud.tasks.v2beta3; -import "google/api/annotations.proto"; import "google/api/resource.proto"; import "google/cloud/tasks/v2beta3/target.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks"; option java_multiple_files = true; @@ -32,6 +32,11 @@ option java_package = "com.google.cloud.tasks.v2beta3"; // how those tasks are dispatched. Configurable properties include rate limits, // retry options, queue types, and others. message Queue { + option (google.api.resource) = { + type: "cloudtasks.googleapis.com/Queue" + pattern: "projects/{project}/locations/{location}/queues/{queue}" + }; + // State of the queue. enum State { // Unspecified state. diff --git a/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2.py index 746d30365e1f..d1f26d01fd07 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2.py +++ b/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2.py @@ -15,13 +15,13 @@ _sym_db = _symbol_database.Default() -from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2beta3.proto import ( target_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2, ) from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 +from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -32,14 +32,14 @@ "\n\036com.google.cloud.tasks.v2beta3B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks" ), serialized_pb=_b( - '\n,google/cloud/tasks_v2beta3/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xf9\x03\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12O\n\x15\x61pp_engine_http_queue\x18\x03 \x01(\x0b\x32..google.cloud.tasks.v2beta3.AppEngineHttpQueueH\x00\x12;\n\x0brate_limits\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.RateLimits\x12=\n\x0cretry_config\x18\x05 \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.RetryConfig\x12\x36\n\x05state\x18\x06 \x01(\x0e\x32\'.google.cloud.tasks.v2beta3.Queue.State\x12.\n\npurge_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x1astackdriver_logging_config\x18\n \x01(\x0b\x32\x34.google.cloud.tasks.v2beta3.StackdriverLoggingConfig"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03\x42\x0c\n\nqueue_type"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05"2\n\x18StackdriverLoggingConfig\x12\x16\n\x0esampling_ratio\x18\x01 \x01(\x01\x42o\n\x1e\x63om.google.cloud.tasks.v2beta3B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3' + '\n,google/cloud/tasks_v2beta3/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xd7\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12O\n\x15\x61pp_engine_http_queue\x18\x03 \x01(\x0b\x32..google.cloud.tasks.v2beta3.AppEngineHttpQueueH\x00\x12;\n\x0brate_limits\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.RateLimits\x12=\n\x0cretry_config\x18\x05 \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.RetryConfig\x12\x36\n\x05state\x18\x06 \x01(\x0e\x32\'.google.cloud.tasks.v2beta3.Queue.State\x12.\n\npurge_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x1astackdriver_logging_config\x18\n \x01(\x0b\x32\x34.google.cloud.tasks.v2beta3.StackdriverLoggingConfig"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\x0c\n\nqueue_type"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05"2\n\x18StackdriverLoggingConfig\x12\x16\n\x0esampling_ratio\x18\x01 \x01(\x01\x42o\n\x1e\x63om.google.cloud.tasks.v2beta3B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3' ), dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -212,7 +212,9 @@ extensions=[], nested_types=[], enum_types=[_QUEUE_STATE], - serialized_options=None, + serialized_options=_b( + "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -226,7 +228,7 @@ ) ], serialized_start=246, - serialized_end=751, + serialized_end=845, ) @@ -300,8 +302,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=753, - serialized_end=859, + serialized_start=847, + serialized_end=953, ) @@ -411,8 +413,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=862, - serialized_end=1071, + serialized_start=956, + serialized_end=1165, ) @@ -450,8 +452,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1073, - serialized_end=1123, + serialized_start=1167, + serialized_end=1217, ) _QUEUE.fields_by_name[ @@ -779,4 +781,5 @@ DESCRIPTOR._options = None +_QUEUE._options = None # @@protoc_insertion_point(module_scope) diff --git a/tasks/google/cloud/tasks_v2beta3/proto/target.proto b/tasks/google/cloud/tasks_v2beta3/proto/target.proto index 48d7df55f11b..f3ef089f40c6 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/target.proto +++ b/tasks/google/cloud/tasks_v2beta3/proto/target.proto @@ -32,8 +32,8 @@ option java_package = "com.google.cloud.tasks.v2beta3"; // 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][Queue.RetryConfig], -// [rate limits][Queue.RateLimits], and the [queue's state][google.cloud.tasks.v2beta3.Queue.state]. +// * User-specified throttling: [retry configuration][google.cloud.tasks.v2beta3.Queue.retry_config], +// [rate limits][google.cloud.tasks.v2beta3.Queue.rate_limits], and the [queue's state][google.cloud.tasks.v2beta3.Queue.state]. // // * System throttling: To prevent the worker from overloading, Cloud Tasks may // temporarily reduce the queue's effective rate. User-specified settings @@ -41,8 +41,8 @@ option java_package = "com.google.cloud.tasks.v2beta3"; // // System throttling happens because: // -// * Cloud Tasks backoffs on all errors. Normally the backoff specified in -// [rate limits][Queue.RateLimits] will be used. But if the worker returns +// * Cloud Tasks backs off on all errors. Normally the backoff specified in +// [rate limits][google.cloud.tasks.v2beta3.Queue.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. @@ -106,7 +106,7 @@ message HttpRequest { // The mode for generating an `Authorization` header for HTTP requests. // - // If specified, all `Authorization` headers in the [HttpTarget.headers][] + // If specified, all `Authorization` headers in the [HttpRequest.headers][google.cloud.tasks.v2beta3.HttpRequest.headers] // field will be overridden. oneof authorization_header { // If specified, an @@ -208,7 +208,7 @@ message AppEngineHttpQueue { // the app's handler returns a non-2xx response code or Cloud Tasks does // not receive response before the [deadline][google.cloud.tasks.v2beta3.Task.dispatch_deadline]. Failed // tasks will be retried according to the -// [retry configuration][Queue.RetryConfig]. `503` (Service Unavailable) is +// [retry configuration][google.cloud.tasks.v2beta3.Queue.retry_config]. `503` (Service Unavailable) is // considered an App Engine system error instead of an application error and // will cause Cloud Tasks' traffic congestion control to temporarily throttle // the queue's dispatches. Unlike other types of task targets, a `429` (Too Many diff --git a/tasks/google/cloud/tasks_v2beta3/proto/target_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/target_pb2.py index 54e7847e7d82..100e2dbcd347 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/target_pb2.py +++ b/tasks/google/cloud/tasks_v2beta3/proto/target_pb2.py @@ -750,9 +750,10 @@ 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][Queue.RetryConfig], - [rate limits][Queue.RateLimits], and the [queue's - state][google.cloud.tasks.v2beta3.Queue.state]. + - User-specified throttling: [retry + configuration][google.cloud.tasks.v2beta3.Queue.retry\_config], [rate + limits][google.cloud.tasks.v2beta3.Queue.rate\_limits], and the + [queue's state][google.cloud.tasks.v2beta3.Queue.state]. - System throttling: To prevent the worker from overloading, Cloud Tasks may temporarily reduce the queue's effective rate. @@ -760,12 +761,12 @@ System throttling happens because: - - Cloud Tasks backoffs on all errors. Normally the backoff specified in - [rate limits][Queue.RateLimits] 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. + - Cloud Tasks backs off on all errors. Normally the backoff specified + in [rate limits][google.cloud.tasks.v2beta3.Queue.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 large traffic spikes, dispatches ramp up slowly when the queue is newly created or idle and @@ -817,8 +818,9 @@ [HttpMethod][google.cloud.tasks.v2beta3.HttpMethod]. authorization_header: The mode for generating an ``Authorization`` header for HTTP - requests. If specified, all ``Authorization`` headers in the - [HttpTarget.headers][] field will be overridden. + requests. If specified, all ``Authorization`` headers in the + [HttpRequest.headers][google.cloud.tasks.v2beta3.HttpRequest.h + eaders] field will be overridden. oauth_token: If specified, an `OAuth token `_ @@ -948,12 +950,13 @@ Tasks does not receive response before the [deadline][google.cloud.tasks.v2beta3.Task.dispatch\_deadline]. Failed tasks will be retried according to the [retry - configuration][Queue.RetryConfig]. ``503`` (Service Unavailable) is - considered an App Engine system error instead of an application error - and will cause Cloud Tasks' traffic congestion control to temporarily - throttle 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. + configuration][google.cloud.tasks.v2beta3.Queue.retry\_config]. ``503`` + (Service Unavailable) is considered an App Engine system error instead + of an application error and will cause Cloud Tasks' traffic congestion + control to temporarily throttle 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. Attributes: diff --git a/tasks/google/cloud/tasks_v2beta3/proto/task.proto b/tasks/google/cloud/tasks_v2beta3/proto/task.proto index 10213ad8590d..573cc85027c1 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/task.proto +++ b/tasks/google/cloud/tasks_v2beta3/proto/task.proto @@ -17,12 +17,12 @@ syntax = "proto3"; package google.cloud.tasks.v2beta3; -import "google/api/annotations.proto"; import "google/api/resource.proto"; import "google/cloud/tasks/v2beta3/target.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/timestamp.proto"; import "google/rpc/status.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks"; option java_multiple_files = true; @@ -31,6 +31,11 @@ option java_package = "com.google.cloud.tasks.v2beta3"; // A unit of scheduled work. message Task { + option (google.api.resource) = { + type: "cloudtasks.googleapis.com/Task" + pattern: "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}" + }; + // The view specifies a subset of [Task][google.cloud.tasks.v2beta3.Task] data. // // When a task is returned in a response, not all diff --git a/tasks/google/cloud/tasks_v2beta3/proto/task_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/task_pb2.py index b59621b9594d..7898b8fcf889 100644 --- a/tasks/google/cloud/tasks_v2beta3/proto/task_pb2.py +++ b/tasks/google/cloud/tasks_v2beta3/proto/task_pb2.py @@ -15,7 +15,6 @@ _sym_db = _symbol_database.Default() -from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2beta3.proto import ( target_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2, @@ -23,6 +22,7 @@ from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2 +from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -33,15 +33,15 @@ "\n\036com.google.cloud.tasks.v2beta3B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks" ), serialized_pb=_b( - '\n+google/cloud/tasks_v2beta3/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xe3\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta3.AppEngineHttpRequestH\x00\x12?\n\x0chttp_request\x18\x0b \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.HttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x0c \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x06 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x07 \x01(\x05\x12:\n\rfirst_attempt\x18\x08 \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x39\n\x0clast_attempt\x18\t \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x33\n\x04view\x18\n \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02\x42\x0e\n\x0cpayload_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta3B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3' + '\n+google/cloud/tasks_v2beta3/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x05\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta3.AppEngineHttpRequestH\x00\x12?\n\x0chttp_request\x18\x0b \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.HttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x0c \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x06 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x07 \x01(\x05\x12:\n\rfirst_attempt\x18\x08 \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x39\n\x0clast_attempt\x18\t \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x33\n\x04view\x18\n \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta3B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3' ), dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, google_dot_rpc_dot_status__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -283,7 +283,9 @@ extensions=[], nested_types=[], enum_types=[_TASK_VIEW], - serialized_options=None, + serialized_options=_b( + "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -297,7 +299,7 @@ ) ], serialized_start=270, - serialized_end=881, + serialized_end=987, ) @@ -389,8 +391,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=884, - serialized_end=1091, + serialized_start=990, + serialized_end=1197, ) _TASK.fields_by_name[ @@ -581,4 +583,5 @@ DESCRIPTOR._options = None +_TASK._options = None # @@protoc_insertion_point(module_scope) diff --git a/tasks/synth.metadata b/tasks/synth.metadata index a91a3aa37760..86ec1727e79d 100644 --- a/tasks/synth.metadata +++ b/tasks/synth.metadata @@ -1,19 +1,19 @@ { - "updateTime": "2019-08-06T12:42:53.795248Z", + "updateTime": "2019-08-21T12:39:33.815307Z", "sources": [ { "generator": { "name": "artman", - "version": "0.32.1", - "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b" + "version": "0.34.0", + "dockerImage": "googleapis/artman@sha256:38a27ba6245f96c3e86df7acb2ebcc33b4f186d9e475efe2d64303aec3d4e0ea" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "e699b0cba64ffddfae39633417180f1f65875896", - "internalRef": "261759677" + "sha": "11592a15391951348a64f5c303399733b1c5b3b2", + "internalRef": "264425502" } }, {