NAME
    gcloud storage insights dataset-configs update - updates a dataset config
        for Insights

SYNOPSIS
    gcloud storage insights dataset-configs update
        (DATASET_CONFIG : --location=LOCATION)
        [--activity-data-retention-period-days=ACTIVITY_DATA_RETENTION_DAYS]
        [--auto-add-new-buckets=AUTO_ADD_NEW_BUCKETS]
        [--description=DESCRIPTION] [--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]
        [--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
    Update a dataset config for Insights.

EXAMPLES
    To update the description for a dataset config "my_config" in location
    "us-central1":

        $ gcloud storage insights dataset-configs update my_config \
          --location=us-central1 \
          --description="a user provided description"

    To update the same dataset config with fully specified name:

        $ gcloud storage insights dataset-configs update \
          projects/foo/locations/us-central1/datasetConfigs/my_config

    To update the retention period days for the dataset config "my_config" in
    location "us-central1":

        $ gcloud storage insights dataset-configs update my_config \
          --location=us-central1 --retention-period-days=20

POSITIONAL ARGUMENTS
     Dataset config resource - The Dataset 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 dataset_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.

       DATASET_CONFIG
          ID of the dataset-config or fully qualified identifier for the
          dataset-config.

          To set the dataset-config attribute:
          ▸ provide the argument dataset_config on the command line.

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

       --location=LOCATION
          Insights supported Google Cloud location for the dataset-config.

          To set the location attribute:
          ▸ provide the argument dataset_config on the command line with a
            fully specified name;
          ▸ provide the argument --location on the command line.

FLAGS
     --activity-data-retention-period-days=ACTIVITY_DATA_RETENTION_DAYS
        Provide retention period for the activity data in the config. This
        overrides the retention period for activity data. Otherwise, the
        retention_period_days value is used for activity data as well.

     --auto-add-new-buckets=AUTO_ADD_NEW_BUCKETS
        Automatically include any new buckets created if they satisfy criteria
        defined in config settings. AUTO_ADD_NEW_BUCKETS must be one of: true,
        false.

     --description=DESCRIPTION
        Description for dataset config.

     --retention-period-days=RETENTION_DAYS
        Provide retention period for the config.

     List of source options either source projects or source folders or enable
     organization scope. Refer Dataset Configuration Properties
     (https://cloud.google.com/storage/docs/insights/datasets#dataset-config)
     for more details.

     At most one of these can 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.

     Specify the list of buckets to be included or excluded, both a list of
     bucket names 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 similar to 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
          include all the buckets that match with the prefix regex. Examples of
          allowed prefix regex patterns can be testbucket*, testbucket.*foo,
          testb.+foo* . It should follow syntax specified in google/re2 on
          GitHub.

     Specify the list of locations for source projects to be included or
     excluded from available locations
     (https://cloud.google.com/storage/docs/locations#available-locations).

     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 help for details.

NOTES
    This variant is also available:

        $ gcloud alpha storage insights dataset-configs update

