Method: folders.locations.savedQueries.patch

Updates an existing SavedQuery.

HTTP request


PATCH https://logging.googleapis.com/v2/{savedQuery.name=folders/*/locations/*/savedQueries/*}

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
savedQuery.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, see Supported 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.

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the savedQuery and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in updateMask are not changed and are ignored in the request.

To update all mutable fields, specify an updateMask of *.

For example, to change the description and query filter text of a saved query, specify an updateMask of "description, query.filter".

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of SavedQuery.

Response body

If successful, the response body contains an instance of SavedQuery.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.