Creates and buffers a new task without the need to explicitly define a Task message. The queue must have HTTP target
. To create the task with a custom ID, use the following format and set TASK_ID to your desired ID: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID:buffer To create the task with an automatically generated ID, use the following format: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks:buffer.
HTTP request
POST https://cloudtasks.googleapis.com/v2/{queue=projects/*/locations/*/queues/*}/tasks/{taskId}:buffer
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
queue |
Required. The parent queue name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist. Authorization requires the following IAM permission on the specified resource
|
taskId |
Optional. Task ID for the task being created. If not provided, Cloud Tasks generates an ID for the task. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"body": {
object ( |
Fields | |
---|---|
body |
Optional. Body of the HTTP request. The body can take any generic value. The value is written to the [HttpRequest][payload] of the [Task]. |
Response body
Response message for tasks.buffer
.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"task": {
object ( |
Fields | |
---|---|
task |
The created task. |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-tasks
For more information, see the Authentication Overview.