.TH "GCLOUD_LOGGING_OPERATIONS_LIST" 1



.SH "NAME"
.HP
gcloud logging operations list \- list long running operations



.SH "SYNOPSIS"
.HP
\f5gcloud logging operations list\fR \fB\-\-location\fR=\fILOCATION\fR \fB\-\-operation\-filter\fR=\fIOPERATION_FILTER\fR [\fB\-\-page\-token\fR=\fIPAGE_TOKEN\fR] [\fB\-\-billing\-account\fR=\fIBILLING_ACCOUNT_ID\fR\ |\ \fB\-\-folder\fR=\fIFOLDER_ID\fR\ |\ \fB\-\-organization\fR=\fIORGANIZATION_ID\fR\ |\ \fB\-\-project\fR=\fIPROJECT_ID\fR] [\fB\-\-limit\fR=\fILIMIT\fR] [\fB\-\-page\-size\fR=\fIPAGE_SIZE\fR] [\fB\-\-sort\-by\fR=[\fIFIELD\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Return a list of long running operations in the given LOCATION. The operations
were scheduled by other gcloud commands.

For example, a CopyLogEntries operation may be scheduled by the command:
\f5gcloud logging copy BUCKET_ID DESTINATION \-\-location=LOCATION\fR.

The \f5\-\-operation\-filter\fR flag is required and must specify the
\f5request_type\fR. Supported request types include but are not limited to:
\f5CopyLogEntries\fR, \f5CreateBucket\fR and \f5UpdateBucket\fR.

Additional supported filter expressions include: \f5operation_start_time\fR,
\f5operation_finish_time\fR and \f5operation_state\fR. These can be combined
with the case\-sensitive keyword \f5AND\fR between them.

For \f5operation_start_time\fR and \f5operation_end_time\fR, the operators >=,
>, <=, and < are supported.

Timestamps must be in either RFC3339 or ISO8601 formats. If the timestamp
contains a time value, then it must be quoted. For examples:
"YYYY\-MM\-DDTHH:MM:SSZ", "YYYY\-MM\-DDTHH:MM:SS.mmmZ", "YY\-MM\-DD",
"YYYY\-MM\-DDTHH:MM:SS\-0000", "YYYY\-MM\-DDTHH:MM+0000", "YYYY\-MM\-DD",
YYYY\-MM\-DD, YY\-MM\-DD, etc.

The \f5operation_state\fR filter expression can be used to filter for operations
that are in a specific state. The value can be one of the following:
\f5SCHEDULED\fR, \f5WAITING_FOR_PRECONDITIONS\fR, \f5RUNNING\fR, \f5SUCCESS\fR,
\f5FAILURE\fR, \f5CANCELLED\fR, \f5PENDING\fR.

For \f5operation_state\fR, the operators = and != are supported.

Other filter options are not supported.



.SH "EXAMPLES"

To list CopyLogEntries operations, run:

.RS 2m
$ gcloud logging operations list \-\-location=LOCATION \e
  \-\-operation\-filter='request_type=CopyLogEntries'
.RE

To list CopyLogEntries operations that started after a specified time, run:

.RS 2m
$ gcloud logging operations list \-\-location=LOCATION \e
  \-\-operation\-filter='request_type=CopyLogEntries AND
operation_start_time>="2023\-11\-20T00:00:00Z"'
.RE

To list CopyLogEntries operations that finished before a specified time, run:

.RS 2m
$ gcloud logging operations list \-\-location=LOCATION \e
  \-\-operation\-filter='request_type=CopyLogEntries AND
operation_finish_time<="2023\-11\-20T00:00:00Z"'
.RE

To list CopyLogEntries operations that completed successfully, run:

.RS 2m
$ gcloud logging operations list \-\-location=LOCATION \e
  \-\-operation\-filter='request_type=CopyLogEntries AND
operation_state=SUCCESS'
.RE

To list CopyLogEntries operations that have not failed, run:

.RS 2m
$ gcloud logging operations list \-\-location=LOCATION \e
  \-\-operation\-filter='request_type=CopyLogEntries AND
operation_state!=FAILURE'
.RE



.SH "REQUIRED FLAGS"

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

Location of the operations.

.TP 2m
\fB\-\-operation\-filter\fR=\fIOPERATION_FILTER\fR

Filter expression that specifies the operations to return.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-page\-token\fR=\fIPAGE_TOKEN\fR

The next_page_token value returned from a previous List request, if any.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-billing\-account\fR=\fIBILLING_ACCOUNT_ID\fR

Billing account of the operations to list.

.TP 2m
\fB\-\-folder\fR=\fIFOLDER_ID\fR

Folder of the operations to list.

.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION_ID\fR

Organization of the operations to list.

.TP 2m
\fB\-\-project\fR=\fIPROJECT_ID\fR

Project of the operations to list.

The Google Cloud project ID to use for this invocation. If omitted, then the
current project is assumed; the current project can be listed using \f5gcloud
config list \-\-format='text(core.project)'\fR and can be set using \f5gcloud
config set project PROJECTID\fR.

\f5\-\-project\fR and its fallback \f5core/project\fR property play two roles in
the invocation. It specifies the project of the resource to operate on. It also
specifies the project for API enablement check, quota, and billing. To specify a
different project for quota and billing, use \f5\-\-billing\-project\fR or
\f5billing/quota_project\fR property.


.RE
.RE
.sp

.SH "LIST COMMAND FLAGS"

.RS 2m
.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\-\-page\-size\fR=\fIPAGE_SIZE\fR

Some services group resource list output into pages. This flag specifies the
maximum number of resources per page. The default is determined by the service
if it supports paging, otherwise it is \fBunlimited\fR (no paging). 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.


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

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