gcloud storage insights inventory-reports update

NAME
gcloud storage insights inventory-reports update - update an inventory report config
SYNOPSIS
gcloud storage insights inventory-reports update(REPORT_CONFIG :--location=LOCATION)[--destination=DESTINATION_URL][--display-name=DISPLAY_NAME][--schedule-repeats=FREQUENCY][--schedule-repeats-until=END_DATE][--schedule-starts=START_DATE][--metadata-fields=[METADATA_FIELDS,…]    |--add-metadata-fields=[METADATA_FIELDS,…]--remove-metadata-fields=[METADATA_FIELDS,…]][--parquet    |--csv-delimiter=DELIMITER--[no-]csv-header--csv-separator=SEPARATOR][GCLOUD_WIDE_FLAG]
DESCRIPTION
Update an inventory report config.
EXAMPLES
To update the display-name of an inventory report config with ID=1234,location=us-central1, and project=foo:
gcloudstorageinsightsinventory-reportsupdate1234--location=us-central1--project=foo--display-name=bar

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

gcloudstorageinsightsinventory-reportsupdate/projects/foo/locations/us-central1/reportConfigs/1234--display-name=bar
POSITIONAL ARGUMENTS
Report config resource - The Report config to update. The arguments in thisgroup can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argumentreport_config on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

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

To set thereport-config attribute:

  • provide the argumentreport_config on the command line.

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

--location=LOCATION
Google Cloud location for the report-config.

To set thelocation attribute:

  • provide the argumentreport_config on the command line with a fullyspecified name;
  • provide the argument--location on the command line.
FLAGS
--destination=DESTINATION_URL
Sets the URL of the destination bucket and path where generated reports arestored.
--display-name=DISPLAY_NAME
Sets the editable name of the report configuration.
--schedule-repeats=FREQUENCY
Sets how often the inventory report configuration will run.FREQUENCY must be one of:daily,weekly.
--schedule-repeats-until=END_DATE
Sets date after which you want to stop generating inventory reports. Forexample, 2022-03-30.
--schedule-starts=START_DATE
Sets the date you want to start generating inventory reports. For example,2022-01-30. Should be tomorrow or later based on UTC timezone.
At most one of these can be specified:
--metadata-fields=[METADATA_FIELDS,…]
The metadata fields to be included in the inventory report. The fields:"project, bucket, name" are REQUIRED.METADATA_FIELDSmust be one of:project,bucket,name,location,size,timeCreated,timeDeleted,updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash,generation,metageneration,contentType,contentEncoding,timeStorageClassUpdated.
Or at least one of these can be specified:
Add and Remove flags for metadata fields
--add-metadata-fields=[METADATA_FIELDS,…]
Adds fields to the metadata_fields list.METADATA_FIELDSmust be one of:location,size,timeCreated,timeDeleted,updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash,generation,metageneration,contentType,contentEncoding,timeStorageClassUpdated.
--remove-metadata-fields=[METADATA_FIELDS,…]
Removes fields from the metadata_fields list.METADATA_FIELDS must be one of:location,size,timeCreated,timeDeleted,updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash,generation,metageneration,contentType,contentEncoding,timeStorageClassUpdated.
Report format configuration. Any combination of CSV flags is valid as long asthe Parquet flag is not present.

At most one of these can be specified:

--parquet
Generate reports in parquet format.
Or at least one of these can be specified:
Flags for setting CSV format options.
--csv-delimiter=DELIMITER
Sets the delimiter that separates the fields in the inventory report CSV file.For example, ``,``
--[no-]csv-header
Indicates whether or not headers are included in the inventory report CSV file.Default is None. Use--csv-header to enable and--no-csv-header to disable.
--csv-separator=SEPARATOR
Sets the character used to separate the records in the inventory report CSVfile. For example, ``\n``.SEPARATOR must be one of:\n,\r\n.
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$gcloud help for details.

NOTES
This variant is also available:
gcloudalphastorageinsightsinventory-reportsupdate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-21 UTC.