imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-18 23:08:48 +00:00
Code Activity

gcloud: Thu Jun 26 10:50:44 UTC 2025

Browse source
This commit is contained in:
Automated 2025-06-26 10:50:44 +00:00
parent 3a534cb57c
commit f645b4c02d
150 changed files with 4099 additions and 393 deletions
Download patch file Download diff file Expand all files Collapse all files

29
gcloud/alpha/storage/insights/dataset-configs/create
View file

@ -6,7 +6,10 @@ SYNOPSIS
gcloud alpha storage insights dataset-configs create DATASET_CONFIG_NAME
--location=LOCATION --organization=SOURCE_ORG_NUMBER
--retention-period-days=RETENTION_DAYS
(--source-projects=[SOURCE_PROJECT_NUMBERS,...]
(--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)
[--auto-add-new-buckets] [--description=DESCRIPTION]
[--identity=IDENTITY_TYPE; default="IDENTITY_TYPE_PER_CONFIG"]
@ -22,17 +25,17 @@ DESCRIPTION
(ALPHA) Create a new dataset config for Insights.
EXAMPLES
To create a dataset config with config name as "my-config" in location
To create a dataset config with config name as "my_config" in location
"us-central1" and project numbers "123456" and "456789" belonging to
organization number "54321":
$ gcloud alpha storage insights dataset-configs create my-config \
$ gcloud alpha storage insights dataset-configs create my_config \
--location=us-central1 --source-projects=123456,456789 \
--organization=54321 --retention-period-days=1
To create a dataset config that automatically adds new buckets into config:
$ gcloud alpha storage insights dataset-configs create my-config \
$ gcloud alpha storage insights dataset-configs create my_config \
--location=us-central1 --source-projects=123456,456789 \
--organization=54321 --auto-add-new-buckets \
--retention-period-days=1
@ -51,10 +54,26 @@ REQUIRED FLAGS
--retention-period-days=RETENTION_DAYS
Provide retention period for the config.
List of source options currently supported are source projects.
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.
Exactly one of these must be specified:
--enable-organization-scope
If passed, the dataset config will be enabled on the organization.
List of source folder IDs or the file containing list of folder IDs.
At most one of these can be specified:
--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.
List of source project numbers or the file containing list of project
numbers.

6
gcloud/alpha/storage/insights/dataset-configs/create-link
View file

@ -12,15 +12,15 @@ DESCRIPTION
EXAMPLES
To create a link to the customer BigQuery instance for config name:
"my-config" in location "us-central1":
"my_config" in location "us-central1":
$ gcloud alpha storage insights dataset-configs create-link \
my-config --location=us-central1
my_config --location=us-central1
To create a link for the same dataset config with fully specified name:
$ gcloud alpha storage insights dataset-configs create-link \
projects/foo/locations/us-central1/datasetConfigs/my-config
projects/foo/locations/us-central1/datasetConfigs/my_config
POSITIONAL ARGUMENTS
Dataset config resource - The Dataset config to create link. The arguments

10
gcloud/alpha/storage/insights/dataset-configs/delete
View file

@ -11,24 +11,24 @@ DESCRIPTION
(ALPHA) Delete an Insights dataset config.
EXAMPLES
To delete a dataset config with config name "my-config" in location
To delete a dataset config with config name "my_config" in location
"us-central1":
$ gcloud alpha storage insights dataset-configs delete my-config \
$ gcloud alpha storage insights dataset-configs delete my_config \
--location=us-central1
To delete the same dataset config with fully specified name:
$gcloud alpha storage insights dataset-configs delete projects/foo/locations/us-central1/datasetConfigs/my-config
$gcloud alpha storage insights dataset-configs delete projects/foo/locations/us-central1/datasetConfigs/my_config
To delete the same dataset config and unlink it from the BigQuery instance:
$ gcloud alpha storage insights dataset-configs delete my-config \
$ gcloud alpha storage insights dataset-configs delete my_config \
--location=us-central1 --auto-delete-link
To delete the same dataset config without taking user consent:
$ gcloud alpha storage insights dataset-configs delete my-config \
$ gcloud alpha storage insights dataset-configs delete my_config \
--location=us-central1 --auto-delete-link --force
POSITIONAL ARGUMENTS

6
gcloud/alpha/storage/insights/dataset-configs/delete-link
View file

@ -10,16 +10,16 @@ DESCRIPTION
(ALPHA) Delete a link to a BigQuery instance.
EXAMPLES
To unlink a dataset config with config name "my-config" in location
To unlink a dataset config with config name "my_config" in location
"us-central1":
$ gcloud alpha storage insights dataset-configs delete-link \
my-config --location=us-central1
my_config --location=us-central1
To delete a link for the same dataset config with fully specified name:
$ gcloud alpha storage insights dataset-configs delete-link \
projects/foo/locations/us-central1/datasetConfigs/my-config
projects/foo/locations/us-central1/datasetConfigs/my_config
POSITIONAL ARGUMENTS
Dataset config resource - The Dataset config to delete link. The arguments

6
gcloud/alpha/storage/insights/dataset-configs/describe
View file

@ -10,16 +10,16 @@ DESCRIPTION
(ALPHA) Describe the Insights dataset config.
EXAMPLES
To describe a dataset config with config name "my-config" in location
To describe a dataset config with config name "my_config" in location
"us-central1":
$ gcloud alpha storage insights dataset-configs describe my-config \
$ gcloud alpha storage insights dataset-configs describe my_config \
--location=us-central1
To describe the same dataset config with fully specified name:
$ gcloud alpha storage insights dataset-configs describe \
projects/foo/locations/us-central1/datasetConfigs/my-config
projects/foo/locations/us-central1/datasetConfigs/my_config
POSITIONAL ARGUMENTS
Dataset config resource - The Dataset config to describe. The arguments in

103
gcloud/alpha/storage/insights/dataset-configs/update
View file

@ -4,29 +4,42 @@ NAME
SYNOPSIS
gcloud alpha storage insights dataset-configs update
(DATASET_CONFIG : --location=LOCATION) [--description=DESCRIPTION]
[--retention-period-days=RETENTION_DAYS] [GCLOUD_WIDE_FLAG ...]
(DATASET_CONFIG : --location=LOCATION)
[--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
(ALPHA) Update a dataset config for Insights.
EXAMPLES
To update the description for a dataset config "my-config" in location
To update the description for a dataset config "my_config" in location
"us-central1":
$ gcloud alpha storage insights dataset-configs update my-config \
$ gcloud alpha 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 alpha storage insights dataset-configs update \
projects/foo/locations/us-central1/datasetConfigs/my-config
projects/foo/locations/us-central1/datasetConfigs/my_config
To update the retention period days for the dataset config "my-config" in
To update the retention period days for the dataset config "my_config" in
location "us-central1":
$ gcloud alpha storage insights dataset-configs update my-config \
$ gcloud alpha storage insights dataset-configs update my_config \
--location=us-central1 --retention-period-days=20
POSITIONAL ARGUMENTS
@ -62,12 +75,88 @@ POSITIONAL ARGUMENTS
▸ provide the argument --location on the command line.
FLAGS
--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.
List of source folder IDs or the file containing list of folder IDs.
At most one of these can be specified:
--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.
List of source project numbers or the file containing list of project
numbers.
At most one of these can be specified:
--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,