.TH "GCLOUD_TASKS_QUEUES_PURGE" 1



.SH "NAME"
.HP
gcloud tasks queues purge \- purge a queue by deleting all of its tasks



.SH "SYNOPSIS"
.HP
\f5gcloud tasks queues purge\fR \fIQUEUE\fR [\fB\-\-location\fR=\fILOCATION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

This command purges a queue by deleting all of its tasks. Purge operations can
take up to one minute to take effect. Tasks might be dispatched before the purge
takes effect. A purge is irreversible. All tasks created before this command is
run are permanently deleted.



.SH "EXAMPLES"

To purge a queue:

.RS 2m
$ gcloud tasks queues purge my\-queue
.RE



.SH "POSITIONAL ARGUMENTS"

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

The queue to purge.


.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.


.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"

These variants are also available:

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

.RS 2m
$ gcloud beta tasks queues purge
.RE