HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: //snap/google-cloud-cli/394/help/man/man1/gcloud_asset_saved-queries_create.1
.TH "GCLOUD_ASSET_SAVED\-QUERIES_CREATE" 1



.SH "NAME"
.HP
gcloud asset saved\-queries create \- create a Cloud Asset Inventory saved query



.SH "SYNOPSIS"
.HP
\f5gcloud asset saved\-queries create\fR \fIQUERY_ID\fR \fB\-\-query\-file\-path\fR=\fIQUERY_FILE_PATH\fR (\fB\-\-folder\fR=\fIFOLDER_ID\fR\ |\ \fB\-\-organization\fR=\fIORGANIZATION_ID\fR\ |\ \fB\-\-project\fR=\fIPROJECT_ID\fR) [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a new Cloud Asset Inventory saved query.



.SH "EXAMPLES"

To create a new saved 'query\-id\-1' in project 'p1' with the content of the
query stored locally in query.json, run:

.RS 2m
$ gcloud asset saved\-queries create query\-id\-1 \-\-project=p1 \e
    \-\-query\-file\-path=./query\-content.json \e
    \-\-description="This is an example saved query with query id \e
query\-id\-1" \-\-labels="key1=val1"
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIQUERY_ID\fR

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


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-query\-file\-path\fR=\fIQUERY_FILE_PATH\fR

Path to JSON or YAML file that contains the query.

.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-folder\fR=\fIFOLDER_ID\fR

Folder of the saved query.

.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION_ID\fR

Organization of the saved query.

.TP 2m
\fB\-\-project\fR=\fIPROJECT_ID\fR

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 \f5gcloud
config list \-\-format='text(core.project)'\fR and can be set using \f5gcloud
config set project PROJECTID\fR.

\f5\-\-project\fR and its fallback \f5core/project\fR property play two roles in
the invocation. It specifies the project of the resource to operate on. It also
specifies the project for API enablement check, quota, and billing. To specify a
different project for quota and billing, use \f5\-\-billing\-project\fR or
\f5billing/quota_project\fR property.


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

A string describing the query.

.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to add.

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


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha asset saved\-queries create
.RE

.RS 2m
$ gcloud beta asset saved\-queries create
.RE