gcloud beta asset saved-queries update

NAME

gcloud beta asset saved-queries update - update an existing Cloud Asset Inventory saved query

SYNOPSIS

gcloud beta asset saved-queries update QUERY_ID (--folder=FOLDER_ID     | --organization=ORGANIZATION_ID     | --project=PROJECT_ID) [--description=DESCRIPTION] [--query-file-path=QUERY_FILE_PATH] [--update-labels=[KEY=VALUE,…]] [--clear-labels     | --remove-labels=[KEY,…]] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(BETA) Update an existing Cloud Asset Inventory saved query.

EXAMPLES

To update the content of an existing saved query, run:

gcloud beta asset saved-queries update query-id-1 --project=p1 --query-file-path=./query-content.json --description="updating a query with query id query-id-1" --update-labels="key1=val1"

POSITIONAL ARGUMENTS

QUERY_ID

Saved query identifier being updated. It must be unique under the specified parent resource project/folder/organization.

REQUIRED FLAGS

Exactly one of these must be specified:

--folder=FOLDER_ID

Folder of the saved query.

--organization=ORGANIZATION_ID

Organization of the saved query.

--project=PROJECT_ID

Project of the saved query.

The Google Cloud project ID to use for this invocation. If omitted, then the current project is assumed; the current project can be listed using gcloud config list --format='text(core.project)' and can be set using gcloud config set project PROJECTID.

--project and its fallback core/project property play two roles in the invocation: they specify both the project of the resource to operate on, and the project for API enablement checks, quota, and billing. To specify a different project for quota and billing, use the --billing-project flag or the billing/quota_project property.

OPTIONAL FLAGS

--description=DESCRIPTION

A string describing the query.

--query-file-path=QUERY_FILE_PATH

Path to JSON or YAML file that contains the query.

--update-labels=[KEY=VALUE,…]

List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created.

Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers. Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.

At most one of these can be specified:

--clear-labels

Remove all labels. If --update-labels is also specified then --clear-labels is applied first.

For example, to remove all labels:

gcloud beta asset saved-queries update --clear-labels

To remove all existing labels and create two new labels, foo and baz:

gcloud beta asset saved-queries update --clear-labels --update-labels foo=bar,baz=qux

--remove-labels=[KEY,…]

List of label keys to remove. If a label does not exist it is silently ignored. If --update-labels is also specified then --update-labels is applied first.

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 beta and might change without notice. These variants are also available:

gcloud asset saved-queries update

gcloud alpha asset saved-queries update