.TH "GCLOUD_LOGGING_LOGS_LIST" 1



.SH "NAME"
.HP
gcloud logging logs list \- list your project's logs



.SH "SYNOPSIS"
.HP
\f5gcloud logging logs list\fR [\fB\-\-bucket\fR=\fIBUCKET\fR\ \fB\-\-location\fR=\fILOCATION\fR\ \fB\-\-view\fR=\fIVIEW\fR] [\fB\-\-filter\fR=\fIEXPRESSION\fR] [\fB\-\-limit\fR=\fILIMIT\fR] [\fB\-\-sort\-by\fR=[\fIFIELD\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Only logs that contain log entries are listed.



.SH "EXAMPLES"

To list all logs in current project:

.RS 2m
$ gcloud logging logs list
.RE

To list all logs for a view:

.RS 2m
$ gcloud logging logs list \-\-bucket=[BUCKET_ID] \e
    \-\-location=[LOCATION] \-\-view=[VIEW_ID]
.RE



.SH "FLAGS"

.RS 2m
.TP 2m

These arguments are used in conjunction with the parent to construct a view
resource.


.RS 2m
.TP 2m
\fB\-\-bucket\fR=\fIBUCKET\fR

Id of the log bucket.

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

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

Location of the log bucket.

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

.TP 2m
\fB\-\-view\fR=\fIVIEW\fR

Id of the view.

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


.RE
.RE
.sp

.SH "LIST COMMAND FLAGS"

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

Apply a Boolean filter \fIEXPRESSION\fR to each resource item to be listed. If
the expression evaluates \f5True\fR, 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: \fB\-\-flatten\fR,
\fB\-\-sort\-by\fR, \fB\-\-filter\fR, \fB\-\-limit\fR.

.TP 2m
\fB\-\-limit\fR=\fILIMIT\fR

Maximum number of resources to list. The default is \fBunlimited\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\-\-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.


.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 logging logs list
.RE

.RS 2m
$ gcloud beta logging logs list
.RE