Method: folders.locations.savedQueries.create

Creates a new SavedQuery for the user making the request.

HTTP request

POST https://logging.googleapis.com/v2/{parent=folders/*/locations/*}/savedQueries

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource in which to create the saved query:

"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/global"
"organizations/123456789/locations/us-central1"

Authorization requires the following IAM permission on the specified resource parent:

  • logging.queries.create

Query parameters

Parameters
savedQueryId

string

Optional. The ID to use for the saved query, which will become the final component of the saved query's resource name.

If the savedQueryId is not provided, the system will generate an alphanumeric ID.

The savedQueryId is limited to 100 characters and can include only the following characters:

  • upper and lower-case alphanumeric characters,
  • underscores,
  • hyphens,
  • periods.

First character has to be alphanumeric.

Request body

The request body contains an instance of SavedQuery.

Response body

If successful, the response body contains a newly created 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.