.TH "GCLOUD_BUILDS_CANCEL" 1



.SH "NAME"
.HP
gcloud builds cancel \- cancel an ongoing build



.SH "SYNOPSIS"
.HP
\f5gcloud builds cancel\fR \fIBUILDS\fR [\fIBUILDS\fR\ ...] [\fB\-\-region\fR=\fIREGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Cancel an ongoing build.



.SH "EXAMPLES"

To cancel a build \f5123\-456\-789\fR:

.RS 2m
$ gcloud builds cancel '123\-456\-789'
.RE

You may also cancel multiple builds at the same time:

.RS 2m
$ gcloud builds cancel '123\-456\-789', '987\-654\-321'
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIBUILDS\fR [\fIBUILDS\fR ...]

IDs of builds to cancel


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-region\fR=\fIREGION\fR

The region of the Cloud Build Service to use. Must be set to a supported region
name (e.g. \f5us\-central1\fR). If unset, \f5builds/region\fR, which is the
default region to use when working with Cloud Build resources, is used. If
builds/region is unset, region is set to \f5global\fR. Note: Region must be
specified in 2nd gen repo; \f5global\fR is not supported.


.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 builds cancel
.RE

.RS 2m
$ gcloud beta builds cancel
.RE