gcloud alpha tasks queues create

NAME
gcloud alpha tasks queues create - create a Cloud Tasks queue
SYNOPSIS
gcloud alpha tasks queues createQUEUE[--http-header-override=HEADER_FIELD:HEADER_VALUE][--http-method-override=HTTP_METHOD_OVERRIDE][--http-uri-override=KEY:VALUE,[KEY:VALUE,…]][--location=LOCATION][--max-attempts=MAX_ATTEMPTS][--max-backoff=MAX_BACKOFF][--max-concurrent-tasks=MAX_CONCURRENT_TASKS][--max-doublings=MAX_DOUBLINGS][--max-retry-duration=MAX_RETRY_DURATION][--max-tasks-dispatched-per-second=MAX_TASKS_DISPATCHED_PER_SECOND][--min-backoff=MIN_BACKOFF][--routing-override=KEY:VALUE,[…]][[--http-oauth-service-account-email-override=HTTP_OAUTH_SERVICE_ACCOUNT_EMAIL_OVERRIDE :--http-oauth-token-scope-override=HTTP_OAUTH_TOKEN_SCOPE_OVERRIDE]    | [--http-oidc-service-account-email-override=HTTP_OIDC_SERVICE_ACCOUNT_EMAIL_OVERRIDE :--http-oidc-token-audience-override=HTTP_OIDC_TOKEN_AUDIENCE_OVERRIDE]][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) The flags available to this command represent the fields ofa queue that are mutable.
EXAMPLES
To create a Cloud Tasks queue:
gcloudalphatasksqueuescreatemy-queue--max-attempts=10--max-retry-duration=5s--max-doublings=4--min-backoff=1s--max-backoff=10s--max-tasks-dispatched-per-second=100--max-concurrent-tasks=10--routing-override=service:abc
POSITIONAL ARGUMENTS
QUEUE
The queue to create.
FLAGS
--http-header-override=HEADER_FIELD:HEADER_VALUE
If provided, the specified HTTP headers override the existing headers for alltasks in the queue. If a task has a header with the same Key as a queue-levelheader override, then the value of the task header will be overriden with thevalue of the queue-level header. Otherwise, the queue-level header will be addedto the task headers. Header values can contain commas. This flag can berepeated. Repeated header fields will have their values overridden.
--http-method-override=HTTP_METHOD_OVERRIDE
If provided, the specified HTTP method type override is used for all tasks inthe queue, no matter what is set at the task-level.
--http-uri-override=KEY:VALUE,[KEY:VALUE,…]
If provided, the specified HTTP target URI override is used for all tasks in thequeue depending on what is set as the mode. Allowed values for mode are: ALWAYS,IF_NOT_EXISTS. If not set, mode defaults to ALWAYS.

KEY must be at least one of: [scheme, host, port, path, query, mode]. Anymissing keys will use the default.

--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.
--max-attempts=MAX_ATTEMPTS
The maximum number of attempts per task in the queue.
--max-backoff=MAX_BACKOFF
The maximum amount of time to wait before retrying a task after it fails. Mustbe a string that ends in 's', such as "5s".
--max-concurrent-tasks=MAX_CONCURRENT_TASKS
The maximum number of concurrent tasks that Cloud Tasks allows to be dispatchedfor this queue. After this threshold has been reached, Cloud Tasks stopsdispatching tasks until the number of outstanding requests decreases.
--max-doublings=MAX_DOUBLINGS
The time between retries will double maxDoublings times.

A tasks retry interval starts at minBackoff, then doubles maxDoublings times,then increases linearly, and finally retries retries at intervals of maxBackoffup to maxAttempts times.

For example, if minBackoff is 10s, maxBackoff is 300s, and maxDoublings is 3,then the a task will first be retried in 10s. The retry interval will doublethree times, and then increase linearly by 2^3 * 10s. Finally, the task willretry at intervals of maxBackoff until the task has been attempted maxAttemptstimes. Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s,300s.

--max-retry-duration=MAX_RETRY_DURATION
The time limit for retrying a failed task, measured from when the task was firstrun. Once the--max-retry-duration time has passed and the task hasbeen attempted --max-attempts times, no further attempts will be made and thetask will be deleted.

Must be a string that ends in 's', such as "5s".

--max-tasks-dispatched-per-second=MAX_TASKS_DISPATCHED_PER_SECOND
The maximum rate at which tasks are dispatched from this queue.
--min-backoff=MIN_BACKOFF
The minimum amount of time to wait before retrying a task after it fails. Mustbe a string that ends in 's', such as "5s".
--routing-override=KEY:VALUE,[…]
If provided, the specified App Engine route is used for all tasks in the queue,no matter what is set is at the task-level.

KEY must be at least one of: [service, version, instance]. Any missing keys willuse the default.

If specified, allAuthorization headers in the HttpRequest.headersfield will be overridden for any tasks executed on this queue.At most one of these can be specified:
OAuth2
--http-oauth-service-account-email-override=HTTP_OAUTH_SERVICE_ACCOUNT_EMAIL_OVERRIDE
The service account email to be used for generating an OAuth2 access token to beincluded in the request sent to the target when executing the task. The serviceaccount must be within the same project as the queue. The caller must have'iam.serviceAccounts.actAs' permission for the service account.

This flag argument must be specified if any of the other arguments in this groupare specified.

--http-oauth-token-scope-override=HTTP_OAUTH_TOKEN_SCOPE_OVERRIDE
The scope to be used when generating an OAuth2 access token to be included inthe request sent to the target when executing the task. If not specified,'https://www.googleapis.com/auth/cloud-platform' will be used.
OpenId Connect
--http-oidc-service-account-email-override=HTTP_OIDC_SERVICE_ACCOUNT_EMAIL_OVERRIDE
The service account email to be used for generating an OpenID Connect token tobe included in the request sent to the target when executing the task. Theservice account must be within the same project as the queue. The caller musthave 'iam.serviceAccounts.actAs' permission for the service account.

This flag argument must be specified if any of the other arguments in this groupare specified.

--http-oidc-token-audience-override=HTTP_OIDC_TOKEN_AUDIENCE_OVERRIDE
The audience to be used when generating an OpenID Connect token to be includedin the request sent to the target when executing the task. If not specified, theURI specified in the target will be used.
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. These variants are also available:
gcloudtasksqueuescreate
gcloudbetatasksqueuescreate

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 2026-01-21 UTC.