REST Resource: projects.locations.savedQueries

Resource: SavedQuery

Describes a query that has been saved by a user.

JSON representation
{"name":string,"displayName":string,"description":string,"createTime":string,"updateTime":string,"visibility":enum (Visibility),// Union fieldquery_oneof can be only one of the following:"loggingQuery":{object (LoggingQuery)},"opsAnalyticsQuery":{object (OpsAnalyticsQuery)}// End of list of possible types for union fieldquery_oneof.}
Fields
name

string

Output only. Resource name of the saved query.

In the format:

"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]"

For a list of supported locations, seeSupported Regions

After the saved query is created, the location cannot be changed.

If the user doesn't provide a [QUERY_ID], the system will generate an alphanumeric ID.

displayName

string

Required. The user specified title for the SavedQuery.

description

string

Optional. A human readable description of the saved query.

createTime

string (Timestamp format)

Output only. The timestamp when the saved query was created.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples:"2014-10-02T15:01:23Z","2014-10-02T15:01:23.045123456Z" or"2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. The timestamp when the saved query was last updated.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples:"2014-10-02T15:01:23Z","2014-10-02T15:01:23.045123456Z" or"2014-10-02T15:01:23+05:30".

visibility

enum (Visibility)

Required. The visibility status of this query, which determines its ownership.

Union fieldquery_oneof. The query that is saved.query_oneof can be only one of the following:
loggingQuery

object (LoggingQuery)

Logging query that can be executed in Logs Explorer or via Logging API.

opsAnalyticsQuery

object (OpsAnalyticsQuery)

Analytics query that can be executed in Log Analytics.

Methods

create

 Creates a new SavedQuery for the user making the request.

delete

 Deletes an existing SavedQuery that was created by the user making the request.

get

 Returns all data associated with the requested query.

list

 Lists the SavedQueries that were created by the user making the request.

patch

 Updates an existing SavedQuery.

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-27 UTC.