|
179 | 179 | "resources": { |
180 | 180 | "queues": { |
181 | 181 | "methods": { |
182 | | - "buffer": { |
183 | | - "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.", |
184 | | - "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}:buffer", |
185 | | - "httpMethod": "POST", |
186 | | - "id": "cloudtasks.projects.locations.queues.buffer", |
187 | | - "parameterOrder": [ |
188 | | - "name" |
189 | | - ], |
190 | | - "parameters": { |
191 | | - "name": { |
192 | | - "description": "Required. The queue name. For example: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist.", |
193 | | - "location": "path", |
194 | | - "pattern": "^projects/[^/]+/locations/[^/]+/queues/[^/]+$", |
195 | | - "required": true, |
196 | | - "type": "string" |
197 | | - } |
198 | | - }, |
199 | | - "path": "v2beta2/{+name}:buffer", |
200 | | - "request": { |
201 | | - "$ref": "BufferQueueRequest" |
202 | | - }, |
203 | | - "response": { |
204 | | - "$ref": "BufferQueueResponse" |
205 | | - }, |
206 | | - "scopes": [ |
207 | | - "https://www.googleapis.com/auth/cloud-platform" |
208 | | - ] |
209 | | - }, |
210 | 182 | "create": { |
211 | 183 | "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.", |
212 | 184 | "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues", |
|
572 | 544 | "https://www.googleapis.com/auth/cloud-platform" |
573 | 545 | ] |
574 | 546 | }, |
| 547 | + "buffer": { |
| 548 | + "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).", |
| 549 | + "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks:buffer", |
| 550 | + "httpMethod": "POST", |
| 551 | + "id": "cloudtasks.projects.locations.queues.tasks.buffer", |
| 552 | + "parameterOrder": [ |
| 553 | + "parent" |
| 554 | + ], |
| 555 | + "parameters": { |
| 556 | + "parent": { |
| 557 | + "description": "Required. The parent queue name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist.", |
| 558 | + "location": "path", |
| 559 | + "pattern": "^projects/[^/]+/locations/[^/]+/queues/[^/]+$", |
| 560 | + "required": true, |
| 561 | + "type": "string" |
| 562 | + } |
| 563 | + }, |
| 564 | + "path": "v2beta2/{+parent}/tasks:buffer", |
| 565 | + "request": { |
| 566 | + "$ref": "BufferTaskRequest" |
| 567 | + }, |
| 568 | + "response": { |
| 569 | + "$ref": "BufferTaskResponse" |
| 570 | + }, |
| 571 | + "scopes": [ |
| 572 | + "https://www.googleapis.com/auth/cloud-platform" |
| 573 | + ] |
| 574 | + }, |
575 | 575 | "cancelLease": { |
576 | 576 | "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.", |
577 | 577 | "flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks/{tasksId}:cancelLease", |
|
837 | 837 | } |
838 | 838 | } |
839 | 839 | }, |
840 | | - "revision": "20220818", |
| 840 | + "revision": "20220909", |
841 | 841 | "rootUrl": "https://cloudtasks.googleapis.com/", |
842 | 842 | "schemas": { |
843 | 843 | "AcknowledgeTaskRequest": { |
|
972 | 972 | "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)." |
973 | 973 | }, |
974 | 974 | "members": { |
975 | | - "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, ` [email protected]` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, ` [email protected]`. * `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, ` [email protected]`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, ` [email protected]?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, ` [email protected]?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, ` [email protected]?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`. ", |
| 975 | + "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, ` [email protected]` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, ` [email protected]`. * `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, ` [email protected]`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, ` [email protected]?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, ` [email protected]?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, ` [email protected]?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`. ", |
976 | 976 | "items": { |
977 | 977 | "type": "string" |
978 | 978 | }, |
|
985 | 985 | }, |
986 | 986 | "type": "object" |
987 | 987 | }, |
988 | | - "BufferQueueRequest": { |
989 | | - "description": "Request message for BufferQueue.", |
990 | | - "id": "BufferQueueRequest", |
| 988 | + "BufferTaskRequest": { |
| 989 | + "description": "Request message for BufferTask.", |
| 990 | + "id": "BufferTaskRequest", |
991 | 991 | "properties": { |
992 | 992 | "body": { |
993 | 993 | "$ref": "HttpBody", |
994 | | - "description": "Body of the HTTP request. The body can take any generic value. The value will be written to the HttpRequest of the [Task]." |
| 994 | + "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]." |
995 | 995 | } |
996 | 996 | }, |
997 | 997 | "type": "object" |
998 | 998 | }, |
999 | | - "BufferQueueResponse": { |
1000 | | - "description": "Response message for BufferQueue.", |
1001 | | - "id": "BufferQueueResponse", |
| 999 | + "BufferTaskResponse": { |
| 1000 | + "description": "Response message for BufferTask.", |
| 1001 | + "id": "BufferTaskResponse", |
1002 | 1002 | "properties": { |
1003 | 1003 | "task": { |
1004 | | - "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.", |
1005 | | - "type": "string" |
| 1004 | + "$ref": "Task", |
| 1005 | + "description": "The created task." |
1006 | 1006 | } |
1007 | 1007 | }, |
1008 | 1008 | "type": "object" |
|
0 commit comments