Method: projects.events.list

Lists the specified events.

HTTP request

GET https://clouderrorreporting.googleapis.com/v1beta1/{projectName=projects/*}/events

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
projectName

string

Required. The resource name of the Google Cloud Platform project. Written asprojects/{projectID} orprojects/{projectID}/locations/{location}, where{projectID} is theGoogle Cloud Platform project ID and{location} is a Cloud region.

Examples:projects/my-project-123,projects/my-project-123/locations/global.

For a list of supported locations, seeSupported Regions.global is the default when unspecified.

Query parameters

Parameters
groupId

string

Required. The group for which events shall be returned. ThegroupId is a unique identifier for a particular error group. The identifier is derived from key parts of the error-log content and is treated as Service Data. For information about how Service Data is handled, seeGoogle Cloud Privacy Notice.

serviceFilter

object (ServiceContextFilter)

Optional. List only ErrorGroups which belong to a service context that matches the filter. Data for all service contexts is returned if this field is not specified.

timeRange

object (QueryTimeRange)

Optional. List only data for the given time range. If not set a default time range is used. The field timeRangeBegin in the response will specify the beginning of this time range.

pageSize

integer

Optional. The maximum number of results to return per response.

pageToken

string

Optional. AnextPageToken provided by a previous response.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance ofListEventsResponse.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/stackdriver-integration

For more information, see theAuthentication Overview.

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 2025-07-14 UTC.