- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Lists the SavedQueries that were created by the user making the request.
HTTP request
GET https://logging.googleapis.com/v2/{parent=folders/*/locations/*}/savedQueries
The URL uses gRPC Transcoding syntax.
Path parameters
parent
string
Required. The resource to which the listed queries belong.
"projects/[PROJECT_ID]/locations/[LOCATION_ID]"
"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]"
"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]"
"folders/[FOLDER_ID]/locations/[LOCATION_ID]"
For example:
"projects/my-project/locations/us-central1"
Note: The locations portion of the resource must be specified. To get a list of all saved queries, a wildcard character -
can be used for [LOCATION_ID], for example:
"projects/my-project/locations/-"
Authorization requires the following IAM
permission on the specified resource parent
:
-
logging.queries.list
Query parameters
pageToken
string
Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken
must be the value of nextPageToken
from the previous response. The values of other method parameters should be identical to those in the previous call.
pageSize
integer
Optional. The maximum number of results to return from this request.
Non-positive values are ignored. The presence of nextPageToken
in the response indicates that more results might be available.
filter
string
Optional. Specifies the type ("Logging" or "OpsAnalytics") and the visibility (PRIVATE or SHARED) of the saved queries to list. If provided, the filter must contain either the type
function or a visibility
token, or both. If both are chosen, they can be placed in any order, but they must be joined by the AND operator or the empty character.
The two supported type
function calls are:
-
type("Logging")
-
type("OpsAnalytics")
The two supported visibility
tokens are:
-
visibility = PRIVATE
-
visibility = SHARED
For example:
type("Logging") AND visibility = PRIVATE
visibility=SHARED type("OpsAnalytics")
type("OpsAnalytics)"
visibility = PRIVATE
visibility = SHARED
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of ListSavedQueriesResponse
.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/logging.read
-
https://www.googleapis.com/auth/logging.admin
-
https://www.googleapis.com/auth/cloud-platform.read-only
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .