.TH "GCLOUD_STORAGE_INSIGHTS_INVENTORY\-REPORTS_UPDATE" 1



.SH "NAME"
.HP
gcloud storage insights inventory\-reports update \- update an inventory report config



.SH "SYNOPSIS"
.HP
\f5gcloud storage insights inventory\-reports update\fR (\fIREPORT_CONFIG\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-destination\fR=\fIDESTINATION_URL\fR] [\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fB\-\-schedule\-repeats\fR=\fIFREQUENCY\fR] [\fB\-\-schedule\-repeats\-until\fR=\fIEND_DATE\fR] [\fB\-\-schedule\-starts\fR=\fISTART_DATE\fR] [\fB\-\-metadata\-fields\fR=[\fIMETADATA_FIELDS\fR,...]\ |\ \fB\-\-add\-metadata\-fields\fR=[\fIMETADATA_FIELDS\fR,...]\ \fB\-\-remove\-metadata\-fields\fR=[\fIMETADATA_FIELDS\fR,...]] [\fB\-\-parquet\fR\ |\ \fB\-\-csv\-delimiter\fR=\fIDELIMITER\fR\ \fB\-\-[no\-]csv\-header\fR\ \fB\-\-csv\-separator\fR=\fISEPARATOR\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update an inventory report config.



.SH "EXAMPLES"

To update the display\-name of an inventory report config with ID=1234,
location=us\-central1, and project=foo:

.RS 2m
$ gcloud storage insights inventory\-reports update 1234 \e
    \-\-location=us\-central1 \-\-project=foo \-\-display\-name=bar
.RE

To update the same inventory report config with fully specified name:

.RS 2m
$ gcloud storage insights inventory\-reports update \e
    /projects/foo/locations/us\-central1/reportConfigs/1234 \e
    \-\-display\-name=bar
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Report config resource \- The Report config to update. The arguments in this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5report_config\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIREPORT_CONFIG\fR

ID of the report\-config or fully qualified identifier for the report\-config.

To set the \f5report\-config\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5report_config\fR on the command line.
.RE
.sp

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

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

Google Cloud location for the report\-config.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5report_config\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-destination\fR=\fIDESTINATION_URL\fR

Sets the URL of the destination bucket and path where generated reports are
stored.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

Sets the editable name of the report configuration.

.TP 2m
\fB\-\-schedule\-repeats\fR=\fIFREQUENCY\fR

Sets how often the inventory report configuration will run. \fIFREQUENCY\fR must
be one of: \fBdaily\fR, \fBweekly\fR.

.TP 2m
\fB\-\-schedule\-repeats\-until\fR=\fIEND_DATE\fR

Sets date after which you want to stop generating inventory reports. For
example, 2022\-03\-30.

.TP 2m
\fB\-\-schedule\-starts\fR=\fISTART_DATE\fR

Sets the date you want to start generating inventory reports. For example,
2022\-01\-30. Should be tomorrow or later based on UTC timezone.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-metadata\-fields\fR=[\fIMETADATA_FIELDS\fR,...]

The metadata fields to be included in the inventory report. The fields:
"project, bucket, name" are REQUIRED. \fIMETADATA_FIELDS\fR must be one of:
\fBproject\fR, \fBbucket\fR, \fBname\fR, \fBlocation\fR, \fBsize\fR,
\fBtimeCreated\fR, \fBtimeDeleted\fR, \fBupdated\fR, \fBstorageClass\fR,
\fBetag\fR, \fBretentionExpirationTime\fR, \fBcrc32c\fR, \fBmd5Hash\fR,
\fBgeneration\fR, \fBmetageneration\fR, \fBcontentType\fR,
\fBcontentEncoding\fR, \fBtimeStorageClassUpdated\fR.

.TP 2m

Add and Remove flags for metadata fields


.RS 2m
.TP 2m
\fB\-\-add\-metadata\-fields\fR=[\fIMETADATA_FIELDS\fR,...]

Adds fields to the metadata_fields list. \fIMETADATA_FIELDS\fR must be one of:
\fBlocation\fR, \fBsize\fR, \fBtimeCreated\fR, \fBtimeDeleted\fR, \fBupdated\fR,
\fBstorageClass\fR, \fBetag\fR, \fBretentionExpirationTime\fR, \fBcrc32c\fR,
\fBmd5Hash\fR, \fBgeneration\fR, \fBmetageneration\fR, \fBcontentType\fR,
\fBcontentEncoding\fR, \fBtimeStorageClassUpdated\fR.

.TP 2m
\fB\-\-remove\-metadata\-fields\fR=[\fIMETADATA_FIELDS\fR,...]

Removes fields from the metadata_fields list. \fIMETADATA_FIELDS\fR must be one
of: \fBlocation\fR, \fBsize\fR, \fBtimeCreated\fR, \fBtimeDeleted\fR,
\fBupdated\fR, \fBstorageClass\fR, \fBetag\fR, \fBretentionExpirationTime\fR,
\fBcrc32c\fR, \fBmd5Hash\fR, \fBgeneration\fR, \fBmetageneration\fR,
\fBcontentType\fR, \fBcontentEncoding\fR, \fBtimeStorageClassUpdated\fR.

.RE
.RE
.sp
.TP 2m

Report format configuration. Any combination of CSV flags is valid as long as
the Parquet flag is not present.

At most one of these can be specified:


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

Generate reports in parquet format.

.TP 2m

Flags for setting CSV format options.


.RS 2m
.TP 2m
\fB\-\-csv\-delimiter\fR=\fIDELIMITER\fR

Sets the delimiter that separates the fields in the inventory report CSV file.
For example, ``,``

.TP 2m
\fB\-\-[no\-]csv\-header\fR

Indicates whether or not headers are included in the inventory report CSV file.
Default is None. Use \fB\-\-csv\-header\fR to enable and
\fB\-\-no\-csv\-header\fR to disable.

.TP 2m
\fB\-\-csv\-separator\fR=\fISEPARATOR\fR

Sets the character used to separate the records in the inventory report CSV
file. For example, ``\en``. \fISEPARATOR\fR must be one of: \fB\en\fR,
\fB\er\en\fR.


.RE
.RE
.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 variant is also available:

.RS 2m
$ gcloud alpha storage insights inventory\-reports update
.RE