feat(cloudtasks)!: update the API

BREAKING CHANGE: This release has breaking changes. #### cloudtasks:v2beta2 The following keys were deleted: - resources.projects.resources.locations.resources.queues.methods.buffer.description - resources.projects.resources.locations.resources.queues.methods.buffer.flatPath - resources.projects.resources.locations.resources.queues.methods.buffer.httpMethod - resources.projects.resources.locations.resources.queues.methods.buffer.id - resources.projects.resources.locations.resources.queues.methods.buffer.parameterOrder - resources.projects.resources.locations.resources.queues.methods.buffer.parameters.name.description - resources.projects.resources.locations.resources.queues.methods.buffer.parameters.name.location - resources.projects.resources.locations.resources.queues.methods.buffer.parameters.name.pattern - resources.projects.resources.locations.resources.queues.methods.buffer.parameters.name.required - resources.projects.resources.locations.resources.queues.methods.buffer.parameters.name.type - resources.projects.resources.locations.resources.queues.methods.buffer.path - resources.projects.resources.locations.resources.queues.methods.buffer.request.$ref - resources.projects.resources.locations.resources.queues.methods.buffer.response.$ref - resources.projects.resources.locations.resources.queues.methods.buffer.scopes - schemas.BufferQueueRequest.description - schemas.BufferQueueRequest.id - schemas.BufferQueueRequest.properties.body.$ref - schemas.BufferQueueRequest.properties.body.description - schemas.BufferQueueRequest.type - schemas.BufferQueueResponse.description - schemas.BufferQueueResponse.id - schemas.BufferQueueResponse.properties.task.description - schemas.BufferQueueResponse.properties.task.type - schemas.BufferQueueResponse.type The following keys were added: - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.description - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.flatPath - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.httpMethod - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.id - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.parameterOrder - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.parameters.parent.description - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.parameters.parent.location - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.parameters.parent.pattern - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.parameters.parent.required - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.parameters.parent.type - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.path - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.request.$ref - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.response.$ref - resources.projects.resources.locations.resources.queues.resources.tasks.methods.buffer.scopes - schemas.BufferTaskRequest.description - schemas.BufferTaskRequest.id - schemas.BufferTaskRequest.properties.body.$ref - schemas.BufferTaskRequest.properties.body.description - schemas.BufferTaskRequest.type - schemas.BufferTaskResponse.description - schemas.BufferTaskResponse.id - schemas.BufferTaskResponse.properties.task.$ref - schemas.BufferTaskResponse.properties.task.description - schemas.BufferTaskResponse.type The following keys were changed: - schemas.Binding.properties.members.description #### cloudtasks:v2beta3 The following keys were changed: - schemas.Binding.properties.members.description #### cloudtasks:v2 The following keys were changed: - schemas.Binding.properties.members.description
googleapis · Sep 21, 2022 · d649e11 · d649e11
1 parent 43bbd5e
commit d649e11
Show file tree

Hide file tree

Showing 7 changed files with 206 additions and 206 deletions.
diff --git a/discovery/cloudtasks-v2.json b/discovery/cloudtasks-v2.json
@@ -685,7 +685,7 @@
       }
     }
   },
-  "revision": "20220818",
+  "revision": "20220909",
   "rootUrl": "https://cloudtasks.googleapis.com/",
   "schemas": {
     "AppEngineHttpRequest": {
@@ -797,7 +797,7 @@
           "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
         },
         "members": {
-          "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+          "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
           "items": {
             "type": "string"
           },

diff --git a/discovery/cloudtasks-v2beta2.json b/discovery/cloudtasks-v2beta2.json
@@ -179,34 +179,6 @@
           "resources": {
             "queues": {
               "methods": {
-                "buffer": {
-                  "description": "Note: This feature is in its experimental stage. You must request access to the API through the [Cloud Tasks BufferQueues Experiment Signup form](https://forms.gle/X8Zr5hiXH5tTGFqh8). Creates and buffers a new task without the need to explicitly define a Task message. The queue must be an http queue (i.e., must have HTTP target). This method is used for a simplified application of Cloud Tasks queues in buffer and rate limitting HTTP requests.",
-                  "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}:buffer",
-                  "httpMethod": "POST",
-                  "id": "cloudtasks.projects.locations.queues.buffer",
-                  "parameterOrder": [
-                    "name"
-                  ],
-                  "parameters": {
-                    "name": {
-                      "description": "Required. The queue name. For example: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist.",
-                      "location": "path",
-                      "pattern": "^projects/[^/]+/locations/[^/]+/queues/[^/]+$",
-                      "required": true,
-                      "type": "string"
-                    }
-                  },
-                  "path": "v2beta2/{+name}:buffer",
-                  "request": {
-                    "$ref": "BufferQueueRequest"
-                  },
-                  "response": {
-                    "$ref": "BufferQueueResponse"
-                  },
-                  "scopes": [
-                    "https://www.googleapis.com/auth/cloud-platform"
-                  ]
-                },
                 "create": {
                   "description": "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. 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. Read [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using this method.",
                   "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues",
@@ -572,6 +544,34 @@
                         "https://www.googleapis.com/auth/cloud-platform"
                       ]
                     },
+                    "buffer": {
+                      "description": "Creates and buffers a new task without the need to explicitly define a Task message. The queue must have HTTP target. Note: This feature is in its experimental stage. You must request access to the API through the [Cloud Tasks BufferTasks Experiment Signup form](https://forms.gle/X8Zr5hiXH5tTGFqh8).",
+                      "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks:buffer",
+                      "httpMethod": "POST",
+                      "id": "cloudtasks.projects.locations.queues.tasks.buffer",
+                      "parameterOrder": [
+                        "parent"
+                      ],
+                      "parameters": {
+                        "parent": {
+                          "description": "Required. The parent queue name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist.",
+                          "location": "path",
+                          "pattern": "^projects/[^/]+/locations/[^/]+/queues/[^/]+$",
+                          "required": true,
+                          "type": "string"
+                        }
+                      },
+                      "path": "v2beta2/{+parent}/tasks:buffer",
+                      "request": {
+                        "$ref": "BufferTaskRequest"
+                      },
+                      "response": {
+                        "$ref": "BufferTaskResponse"
+                      },
+                      "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform"
+                      ]
+                    },
                     "cancelLease": {
                       "description": "Cancel a pull task's lease. The worker can use this method to cancel a task's lease by setting its schedule_time to now. This will make the task available to be leased to the next caller of LeaseTasks.",
                       "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks/{tasksId}:cancelLease",
@@ -837,7 +837,7 @@
       }
     }
   },
-  "revision": "20220818",
+  "revision": "20220909",
   "rootUrl": "https://cloudtasks.googleapis.com/",
   "schemas": {
     "AcknowledgeTaskRequest": {
@@ -972,7 +972,7 @@
           "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
         },
         "members": {
-          "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+          "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
           "items": {
             "type": "string"
           },
@@ -985,24 +985,24 @@
       },
       "type": "object"
     },
-    "BufferQueueRequest": {
-      "description": "Request message for BufferQueue.",
-      "id": "BufferQueueRequest",
+    "BufferTaskRequest": {
+      "description": "Request message for BufferTask.",
+      "id": "BufferTaskRequest",
       "properties": {
         "body": {
           "$ref": "HttpBody",
-          "description": "Body of the HTTP request. The body can take any generic value. The value will be written to the HttpRequest of the [Task]."
+          "description": "Optional. Body of the HTTP request. The body can take any generic value. The value will be written to the HttpRequest of the [Task]."
         }
       },
       "type": "object"
     },
-    "BufferQueueResponse": {
-      "description": "Response message for BufferQueue.",
-      "id": "BufferQueueResponse",
+    "BufferTaskResponse": {
+      "description": "Response message for BufferTask.",
+      "id": "BufferTaskResponse",
       "properties": {
         "task": {
-          "description": "The name of the created task. For example: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. TASK_ID is randomly generated and is unique within the queue.",
-          "type": "string"
+          "$ref": "Task",
+          "description": "The created task."
         }
       },
       "type": "object"