gcloud alpha storage insights inventory-reports update

NAME
gcloud alpha storage insights inventory-reports update - update an inventory report config
SYNOPSIS
gcloud alpha 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
(ALPHA) 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:
gcloud alpha storage insights inventory-reports update 1234 --location=us-central1 --project=foo --display-name=bar

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

gcloud alpha storage insights inventory-reports update /projects/foo/locations/us-central1/reportConfigs/1234 --display-name=bar
POSITIONAL ARGUMENTS
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 project attribute:

  • provide the argument report_config on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

This must be specified.

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

To set the report-config attribute:

  • provide the argument report_config on the command line.

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

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

To set the location attribute:

  • provide the argument report_config on the command line with a fully specified 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 are stored.
--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. For example, 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_FIELDS must be one of: project, bucket, name, location, size, timeCreated, timeDeleted, updated, storageClass, etag, retentionExpirationTime, crc32c, md5Hash, generation, metageneration, contentType, contentEncoding, timeStorageClassUpdated.
Add and Remove flags for metadata fields
--add-metadata-fields=[METADATA_FIELDS,…]
Adds fields to 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.
--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 as the Parquet flag is not present.

At most one of these can be specified:

--parquet
Generate reports in parquet format.
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 CSV file. 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 command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. This variant is also available:
gcloud storage insights inventory-reports update