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

