.TH "GCLOUD_BETA_TASKS_QUEUES_UPDATE" 1



.SH "NAME"
.HP
gcloud beta tasks queues update \- update a Cloud Tasks queue



.SH "SYNOPSIS"
.HP
\f5gcloud beta tasks queues update\fR \fIQUEUE\fR [\fB\-\-location\fR=\fILOCATION\fR] [\fB\-\-type\fR=\fITYPE\fR;\ default="push"] [\fB\-\-clear\-http\-header\-override\fR\ |\ \fB\-\-http\-header\-override\fR=\fIHEADER_FIELD\fR:\ \fIHEADER_VALUE\fR] [\fB\-\-clear\-http\-method\-override\fR\ |\ \fB\-\-http\-method\-override\fR=\fIHTTP_METHOD_OVERRIDE\fR] [\fB\-\-clear\-http\-oauth\-service\-account\-email\-override\fR\ |\ \fB\-\-http\-oauth\-service\-account\-email\-override\fR=\fIHTTP_OAUTH_SERVICE_ACCOUNT_EMAIL_OVERRIDE\fR] [\fB\-\-clear\-http\-oauth\-token\-scope\-override\fR\ |\ \fB\-\-http\-oauth\-token\-scope\-override\fR=\fIHTTP_OAUTH_TOKEN_SCOPE_OVERRIDE\fR] [\fB\-\-clear\-http\-oidc\-service\-account\-email\-override\fR\ |\ \fB\-\-http\-oidc\-service\-account\-email\-override\fR=\fIHTTP_OIDC_SERVICE_ACCOUNT_EMAIL_OVERRIDE\fR] [\fB\-\-clear\-http\-oidc\-token\-audience\-override\fR\ |\ \fB\-\-http\-oidc\-token\-audience\-override\fR=\fIHTTP_OIDC_TOKEN_AUDIENCE_OVERRIDE\fR] [\fB\-\-clear\-http\-uri\-override\fR\ |\ \fB\-\-http\-uri\-override\fR=\fIKEY\fR:\fIVALUE\fR,[\fIKEY\fR:\fIVALUE\fR,...]] [\fB\-\-clear\-log\-sampling\-ratio\fR\ |\ \fB\-\-log\-sampling\-ratio\fR=\fILOG_SAMPLING_RATIO\fR] [\fB\-\-clear\-max\-attempts\fR\ |\ \fB\-\-max\-attempts\fR=\fIMAX_ATTEMPTS\fR] [\fB\-\-clear\-max\-backoff\fR\ |\ \fB\-\-max\-backoff\fR=\fIMAX_BACKOFF\fR] [\fB\-\-clear\-max\-concurrent\-dispatches\fR\ |\ \fB\-\-max\-concurrent\-dispatches\fR=\fIMAX_CONCURRENT_DISPATCHES\fR] [\fB\-\-clear\-max\-dispatches\-per\-second\fR\ |\ \fB\-\-max\-dispatches\-per\-second\fR=\fIMAX_DISPATCHES_PER_SECOND\fR] [\fB\-\-clear\-max\-doublings\fR\ |\ \fB\-\-max\-doublings\fR=\fIMAX_DOUBLINGS\fR] [\fB\-\-clear\-max\-retry\-duration\fR\ |\ \fB\-\-max\-retry\-duration\fR=\fIMAX_RETRY_DURATION\fR] [\fB\-\-clear\-min\-backoff\fR\ |\ \fB\-\-min\-backoff\fR=\fIMIN_BACKOFF\fR] [\fB\-\-clear\-routing\-override\fR\ |\ \fB\-\-routing\-override\fR=\fIKEY\fR:\fIVALUE\fR,[...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR The flags available to this command represent the fields of a queue
that are mutable.



.SH "EXAMPLES"

To update a Cloud Tasks queue:

.RS 2m
$ gcloud beta tasks queues update my\-queue \-\-clear\-max\-attempts \e
  \-\-clear\-max\-retry\-duration \-\-clear\-max\-doublings \e
  \-\-clear\-min\-backoff \-\-clear\-max\-backoff \e
  \-\-clear\-max\-dispatches\-per\-second \e
  \-\-clear\-max\-concurrent\-dispatches \-\-clear\-routing\-override
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIQUEUE\fR

The queue to update.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

The location where we want to manage the queue or task. If not specified, uses
the location of the current project's App Engine app if there is an associated
app.

.TP 2m
\fB\-\-type\fR=\fITYPE\fR; default="push"

Specifies the type of queue. Only available options are 'push' and 'pull'. The
default option is 'push'.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-http\-header\-override\fR

Clear the field corresponding to \f5\-\-http\-header\-override\fR.

.TP 2m
\fB\-\-http\-header\-override\fR=\fIHEADER_FIELD\fR: \fIHEADER_VALUE\fR

If provided, the specified HTTP headers override the existing headers for all
tasks in the queue. If a task has a header with the same Key as a queue\-level
header override, then the value of the task header will be overriden with the
value of the queue\-level header. Otherwise, the queue\-level header will be
added to the task headers. Header values can contain commas. This flag can be
repeated. Repeated header fields will have their values overridden.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-http\-method\-override\fR

Clear the field corresponding to \f5\-\-http\-method\-override\fR.

.TP 2m
\fB\-\-http\-method\-override\fR=\fIHTTP_METHOD_OVERRIDE\fR

If provided, the specified HTTP method type override is used for all tasks in
the queue, no matter what is set at the task\-level.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-http\-oauth\-service\-account\-email\-override\fR

Clear the field corresponding to
\f5\-\-http\-oauth\-service\-account\-email\-override\fR.

.TP 2m
\fB\-\-http\-oauth\-service\-account\-email\-override\fR=\fIHTTP_OAUTH_SERVICE_ACCOUNT_EMAIL_OVERRIDE\fR

The service account email to be used for generating an OAuth2 access token to be
included in the request sent to the target when executing the task. The service
account must be within the same project as the queue. The caller must have
\'iam.serviceAccounts.actAs' permission for the service account.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-http\-oauth\-token\-scope\-override\fR

Clear the field corresponding to \f5\-\-http\-oauth\-token\-scope\-override\fR.

.TP 2m
\fB\-\-http\-oauth\-token\-scope\-override\fR=\fIHTTP_OAUTH_TOKEN_SCOPE_OVERRIDE\fR

The scope to be used when generating an OAuth2 access token to be included in
the request sent to the target when executing the task. If not specified,
\'https://www.googleapis.com/auth/cloud\-platform' will be used.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-http\-oidc\-service\-account\-email\-override\fR

Clear the field corresponding to
\f5\-\-http\-oidc\-service\-account\-email\-override\fR.

.TP 2m
\fB\-\-http\-oidc\-service\-account\-email\-override\fR=\fIHTTP_OIDC_SERVICE_ACCOUNT_EMAIL_OVERRIDE\fR

The service account email to be used for generating an OpenID Connect token to
be included in the request sent to the target when executing the task. The
service account must be within the same project as the queue. The caller must
have 'iam.serviceAccounts.actAs' permission for the service account.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-http\-oidc\-token\-audience\-override\fR

Clear the field corresponding to
\f5\-\-http\-oidc\-token\-audience\-override\fR.

.TP 2m
\fB\-\-http\-oidc\-token\-audience\-override\fR=\fIHTTP_OIDC_TOKEN_AUDIENCE_OVERRIDE\fR

The audience to be used when generating an OpenID Connect token to be included
in the request sent to the target when executing the task. If not specified, the
URI specified in the target will be used.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-http\-uri\-override\fR

Clear the field corresponding to \f5\-\-http\-uri\-override\fR.

.TP 2m
\fB\-\-http\-uri\-override\fR=\fIKEY\fR:\fIVALUE\fR,[\fIKEY\fR:\fIVALUE\fR,...]

If provided, the specified HTTP target URI override is used for all tasks in the
queue 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]. Any
missing keys will use the default.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-log\-sampling\-ratio\fR

Clear the field corresponding to \f5\-\-log\-sampling\-ratio\fR.

.TP 2m
\fB\-\-log\-sampling\-ratio\fR=\fILOG_SAMPLING_RATIO\fR

Specifies the fraction of operations to write to Cloud Logging. This field may
contain any value between 0.0 and 1.0, inclusive. 0.0 is the default and means
that no operations are logged.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-max\-attempts\fR

Clear the field corresponding to \f5\-\-max\-attempts\fR.

.TP 2m
\fB\-\-max\-attempts\fR=\fIMAX_ATTEMPTS\fR

The maximum number of attempts per task in the queue.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-max\-backoff\fR

Clear the field corresponding to \f5\-\-max\-backoff\fR.

.TP 2m
\fB\-\-max\-backoff\fR=\fIMAX_BACKOFF\fR

The maximum amount of time to wait before retrying a task after it fails. Must
be a string that ends in 's', such as "5s".

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-max\-concurrent\-dispatches\fR

Clear the field corresponding to \f5\-\-max\-concurrent\-dispatches\fR.

.TP 2m
\fB\-\-max\-concurrent\-dispatches\fR=\fIMAX_CONCURRENT_DISPATCHES\fR

The maximum number of concurrent tasks that Cloud Tasks allows to be dispatched
for this queue. After this threshold has been reached, Cloud Tasks stops
dispatching tasks until the number of outstanding requests decreases.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-max\-dispatches\-per\-second\fR

Clear the field corresponding to \f5\-\-max\-dispatches\-per\-second\fR.

.TP 2m
\fB\-\-max\-dispatches\-per\-second\fR=\fIMAX_DISPATCHES_PER_SECOND\fR

The maximum rate at which tasks are dispatched from this queue.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-max\-doublings\fR

Clear the field corresponding to \f5\-\-max\-doublings\fR.

.TP 2m
\fB\-\-max\-doublings\fR=\fIMAX_DOUBLINGS\fR

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 maxBackoff
up 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 double
three times, and then increase linearly by 2^3 * 10s. Finally, the task will
retry at intervals of maxBackoff until the task has been attempted maxAttempts
times. Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s,
300s.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-max\-retry\-duration\fR

Clear the field corresponding to \f5\-\-max\-retry\-duration\fR.

.TP 2m
\fB\-\-max\-retry\-duration\fR=\fIMAX_RETRY_DURATION\fR

The time limit for retrying a failed task, measured from when the task was first
run. Once the \f5\-\-max\-retry\-duration\fR time has passed and the task has
been attempted \-\-max\-attempts times, no further attempts will be made and the
task will be deleted.

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

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-min\-backoff\fR

Clear the field corresponding to \f5\-\-min\-backoff\fR.

.TP 2m
\fB\-\-min\-backoff\fR=\fIMIN_BACKOFF\fR

The minimum amount of time to wait before retrying a task after it fails. Must
be a string that ends in 's', such as "5s".

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-routing\-override\fR

Clear the field corresponding to \f5\-\-routing\-override\fR.

.TP 2m
\fB\-\-routing\-override\fR=\fIKEY\fR:\fIVALUE\fR,[...]

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 will
use the default.


.RE
.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud tasks queues update
.RE

.RS 2m
$ gcloud alpha tasks queues update
.RE