Console
Start free

gcloud alpha storage insights inventory-reports create

NAME
gcloud alpha storage insights inventory-reports create - create a new inventory report config
SYNOPSIS
gcloud alpha storage insights inventory-reports create SOURCE_BUCKET_URL [--destination=DESTINATION_URL] [--display-name=DISPLAY_NAME] [--metadata-fields=[METADATA_FIELDS,…]; default="project,bucket,name,location,size,timeCreated,timeDeleted,updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash,generation,metageneration,contentType,contentEncoding,timeStorageClassUpdated"] [--schedule-repeats=FREQUENCY; default="daily"] [--schedule-repeats-until=END_DATE] [--schedule-starts=START_DATE] [--parquet     | --csv-delimiter=DELIMITER --[no-]csv-header --csv-separator=SEPARATOR] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Create an inventory report config that defines how often inventory reports are generated, the metadata fields you want the reports to include, and a bucket/prefix in which to store the reports, also known as the destination.
EXAMPLES
To create an inventory report about "my-bucket" that will store report details in "report-bucket" with the prefix "save-path/". 
gcloud alpha storage insights inventory-reports create gs://my-bucket --destination=gs://report-bucket/save-path/
POSITIONAL ARGUMENTS
SOURCE_BUCKET_URL
URL of the source bucket that will contain the inventory report configuration.
FLAGS
--destination=DESTINATION_URL
Sets the URL of the destination bucket and path where generated reports are stored. Defaults to <SOURCE_BUCKET_URL>/inventory_reports/.
--display-name=DISPLAY_NAME
Sets the editable name of the report configuration.
--metadata-fields=[METADATA_FIELDS,…]; default="project,bucket,name,location,size,timeCreated,timeDeleted,updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash,generation,metageneration,contentType,contentEncoding,timeStorageClassUpdated"
The metadata fields to be included in the inventory report. The fields: "project, bucket, name" are REQUIRED. Defaults to all fields being included. METADATA_FIELDS must be one of: project, bucket, name, location, size, timeCreated, timeDeleted, updated, storageClass, etag, retentionExpirationTime, crc32c, md5Hash, generation, metageneration, contentType, contentEncoding, timeStorageClassUpdated.
--schedule-repeats=FREQUENCY; default="daily"
Sets how often the inventory report configuration will run. Defaults to DAILY. 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. Defaults to one year from --schedule-starts value.
--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. Defaults to tomorrow.
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.
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 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 create