Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-134794214.4 KB
projects

Creates a new SavedQuery for the user making the request.

post/v2/{+parent}/savedQueries

Path parameters

parentstring required

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"

Query parameters

savedQueryIdstring

Optional. The ID to use for the saved query, which will become the final component of the saved query's resource name.If the saved_query_id is not provided, the system will generate an alphanumeric ID.The saved_query_id 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

displayNamestring

Required. The user specified title for the SavedQuery.

updateTimestring google-datetime

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

createTimestring google-datetime

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

visibility'VISIBILITY_UNSPECIFIED' | 'PRIVATE' | 'SHARED'

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

namestring

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 (https://docs.cloud.google.com/logging/docs/region-support#bucket-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.

descriptionstring

Optional. A human readable description of the saved query.

Response

Successful response