gcloud storage insights dataset-configs create Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud storage insights dataset-configs create - create a new dataset config for Insights
- SYNOPSIS
gcloud storage insights dataset-configs createDATASET_CONFIG_NAME--location=LOCATION--organization=SOURCE_ORG_NUMBER--retention-period-days=RETENTION_DAYS(--enable-organization-scope|--source-folders=[SOURCE_FOLDER_NUMBERS,…] |--source-folders-file=SOURCE_FOLDER_NUMBERS_IN_FILE|--source-projects=[SOURCE_PROJECT_NUMBERS,…] |--source-projects-file=SOURCE_PROJECT_NUMBERS_IN_FILE)[--activity-data-retention-period-days=ACTIVITY_DATA_RETENTION_DAYS][--auto-add-new-buckets][--description=DESCRIPTION][--identity=IDENTITY_TYPE; default="IDENTITY_TYPE_PER_CONFIG"][--exclude-bucket-names=[BUCKETS_NAMES,…]--exclude-bucket-prefix-regexes=[BUCKETS_REGEXES,…] |--include-bucket-names=[BUCKETS_NAMES,…]--include-bucket-prefix-regexes=[BUCKETS_REGEXES,…]][--exclude-source-locations=[LIST_OF_SOURCE_LOCATIONS,…] |--include-source-locations=[LIST_OF_SOURCE_LOCATIONS,…]][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
- Create a new dataset config for Insights.
- EXAMPLES
- To create a dataset config with config name as "my_config" in location"us-central1" and project numbers "123456" and "456789" belonging toorganization number "54321":
gcloudstorageinsightsdataset-configscreatemy_config--location=us-central1--source-projects=123456,456789--organization=54321--retention-period-days=1To create a dataset config that automatically adds new buckets into config:
gcloudstorageinsightsdataset-configscreatemy_config--location=us-central1--source-projects=123456,456789--organization=54321--auto-add-new-buckets--retention-period-days=1 - POSITIONAL ARGUMENTS
DATASET_CONFIG_NAME- Provide human readable config name.
- REQUIRED FLAGS
--location=LOCATION- Provide location of the dataset config.
--organization=SOURCE_ORG_NUMBER- Provide the source organization number.
--retention-period-days=RETENTION_DAYS- Provide retention period for the config.
- List of source options either source projects or source folders or enableorganization scope. ReferDatasetConfiguration Properties for more details.
Exactly one of these must be specified:
--enable-organization-scope- If passed, the dataset config will be enabled on the organization.
- Or at most one of these can be specified:
- List of source folder IDs or the file containing list of folder IDs.
--source-folders=[SOURCE_FOLDER_NUMBERS,…]- List of source folder IDs.
--source-folders-file=SOURCE_FOLDER_NUMBERS_IN_FILE- CSV formatted file containing source folder IDs, one per line.
- Or at most one of these can be specified:
- List of source project numbers or the file containing list of project numbers.
--source-projects=[SOURCE_PROJECT_NUMBERS,…]- List of source project numbers.
--source-projects-file=SOURCE_PROJECT_NUMBERS_IN_FILE- CSV formatted file containing source project numbers, one per line.
- OPTIONAL FLAGS
--activity-data-retention-period-days=ACTIVITY_DATA_RETENTION_DAYS- Provide retention period for the activity data in the config. This overrides theretention period for activity data. Otherwise, the
retention_period_daysvalue is used for activity data as well. --auto-add-new-buckets- Automatically include any new buckets created if they satisfy criteria definedin config settings.
--description=DESCRIPTION- Description for dataset config.
--identity=IDENTITY_TYPE; default="IDENTITY_TYPE_PER_CONFIG"- The type of service account used in the dataset config.
IDENTITY_TYPEmust be one of:IDENTITY_TYPE_PER_CONFIG,IDENTITY_TYPE_PER_PROJECT. - Specify the list of buckets to be included or excluded, both a list of bucketnames and prefix regexes can be specified for either include or exclude buckets.
At most one of these can be specified:
- Specify the list of buckets to be excluded.
--exclude-bucket-names=[BUCKETS_NAMES,…]- List of bucket names to be excluded.
--exclude-bucket-prefix-regexes=[BUCKETS_REGEXES,…]- List of bucket prefix regexes to be excluded. Allowed regex patterns are similarto those for the --include-bucket-prefix-regexes flag.
- Specify the list of buckets to be included.
--include-bucket-names=[BUCKETS_NAMES,…]- List of bucket names be included.
--include-bucket-prefix-regexes=[BUCKETS_REGEXES,…]- List of bucket prefix regexes to be included. The dataset config will includeall the buckets that match with the prefix regex. Examples of allowed prefixregex patterns can be testbucket
*, testbucket.*foo,testb.+foo*. It should follow syntax specified in google/re2 onGitHub.
- Specify the list of locations for source projects to be included or excludedfromavailablelocations.
At most one of these can be specified:
--exclude-source-locations=[LIST_OF_SOURCE_LOCATIONS,…]- List of locations for projects to be excluded.
--include-source-locations=[LIST_OF_SOURCE_LOCATIONS,…]- List of locations for projects to be included.
- 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 helpfor details. - NOTES
- This variant is also available:
gcloudalphastorageinsightsdataset-configscreate
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.