.TH "GCLOUD_BETA_BUILDS_LIST" 1



.SH "NAME"
.HP
gcloud beta builds list \- list builds



.SH "SYNOPSIS"
.HP
\f5gcloud beta builds list\fR [\fB\-\-ongoing\fR] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-filter\fR=\fIEXPRESSION\fR] [\fB\-\-limit\fR=\fILIMIT\fR;\ default=50] [\fB\-\-page\-size\fR=\fIPAGE_SIZE\fR;\ default=20] [\fB\-\-sort\-by\fR=[\fIFIELD\fR,...]] [\fB\-\-uri\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR List builds.



.SH "EXAMPLES"

To list all completed builds in the current project:

.RS 2m
$ gcloud beta builds list
.RE

To list all builds in the current project in QUEUED or WORKING status.:

.RS 2m
$ gcloud beta builds list \-\-ongoing
.RE



.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-ongoing\fR

Only list builds that are currently QUEUED or WORKING.

.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 "LIST COMMAND FLAGS"

.RS 2m
.TP 2m
\fB\-\-filter\fR=\fIEXPRESSION\fR

Apply a Boolean filter EXPRESSION to each resource item to be listed. If the
expression evaluates True, then that item is listed. For more details and
examples of filter expressions, run $ gcloud topic filters. This flag interacts
with other flags that are applied in this order: \-\-flatten, \-\-sort\-by,
\-\-filter, \-\-limit.

.TP 2m
\fB\-\-limit\fR=\fILIMIT\fR; default=50

Maximum number of resources to list. The default is \fB50\fR. This flag
interacts with other flags that are applied in this order: \fB\-\-flatten\fR,
\fB\-\-sort\-by\fR, \fB\-\-filter\fR, \fB\-\-limit\fR.

.TP 2m
\fB\-\-page\-size\fR=\fIPAGE_SIZE\fR; default=20

Some services group resource list output into pages. This flag specifies the
maximum number of resources per page. The default is \fB20\fR. Paging may be
applied before or after \fB\-\-filter\fR and \fB\-\-limit\fR depending on the
service.

.TP 2m
\fB\-\-sort\-by\fR=[\fIFIELD\fR,...]

Comma\-separated list of resource field key names to sort by. The default order
is ascending. Prefix a field with ``~'' for descending order on that field. This
flag interacts with other flags that are applied in this order:
\fB\-\-flatten\fR, \fB\-\-sort\-by\fR, \fB\-\-filter\fR, \fB\-\-limit\fR.

.TP 2m
\fB\-\-uri\fR

Print a list of resource URIs instead of the default output, and change the
command output to a list of URIs. If this flag is used with \fB\-\-format\fR,
the formatting is applied on this URI list. To display URIs alongside other keys
instead, use the \fBuri()\fR transform.


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

.RS 2m
$ gcloud alpha builds list
.RE