gcloud alpha tasks create-pull-task

NAME
gcloud alpha tasks create-pull-task - create and add a task to a pull queue
SYNOPSIS
gcloud alpha tasks create-pull-task[TASK_ID]--queue=QUEUE[--location=LOCATION][--schedule-time=SCHEDULE_TIME][--tag=TAG][--payload-content=PAYLOAD_CONTENT    |--payload-file=PAYLOAD_FILE][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Create and add a task to a pull queue.
POSITIONAL ARGUMENTS
[TASK_ID]
The task to create.

If not specified then the system will generate a random unique task ID.Explicitly specifying a task ID enables task de-duplication. If a task's ID isidentical to that of an existing task or a task that was deleted or completedrecently then the call will fail.

Because there is an extra lookup cost to identify duplicate task names, taskscreated with IDs have significantly increased latency. Using hashed strings forthe task ID or for the prefix of the task ID is recommended.

REQUIRED FLAGS
--queue=QUEUE
The queue the task belongs to.
OPTIONAL FLAGS
--location=LOCATION
The location where we want to manage the queue or task. If not specified, usesthe location of the current project's App Engine app if there is an associatedapp.
--schedule-time=SCHEDULE_TIME
The time when the task is scheduled to be first attempted. Defaults to "now" ifnot specified.
--tag=TAG
An optional label used to group similar tasks.
At most one of these can be specified:
--payload-content=PAYLOAD_CONTENT
Data payload used by the task worker to process the task.
--payload-file=PAYLOAD_FILE
File containing data payload used by the task worker to process the task.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.