Optional. A filter expression that filters resources listed in the
response. The expression takes the following forms: <br>
field=value for category and state<br>
field <, >, <=, or >= value for update_time <br>
Examples: category=INCIDENT, update_time>="2000-01-01T11:30:00-04:00",
event_impacts.product.product_name:"Eventarc"
<br>
Multiple filter queries are separated by spaces. Example:
category=INCIDENT state=ACTIVE.
By default, each expression is an AND expression. However, you can include
AND and OR expressions explicitly.
Filter is supported for the following fields: category, state,
update_time, event_impacts.product.product_name
Optional. The maximum number of events that should be returned. Acceptable
values are 1 to 100, inclusive. (The default value is 10.) If more results
are available, the service returns a next_page_token that you can use to
get the next page of results in subsequent list requests. The service may
return fewer events than the requested page_size.
Optional. A token identifying a page of results the server should return.
Provide Page token returned by a previous ListEvents call to retrieve the
next page of results. When paginating, all other parameters provided to
ListEvents must match the call that provided the page token.
Required. Parent value using the form
projects/{project_id}/locations/{location}/events.
project_id - ID of the project for which to list service health
events.
location - The location to get the service health events from.
To retrieve service health events of category = INCIDENT, use location =
global.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eListEventsRequest\u003c/code\u003e class is used to request a list of events from the Service Health v1 API, and it is the message that is used to do so.\u003c/p\u003e\n"],["\u003cp\u003eThis class implements multiple interfaces including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, \u003ccode\u003eIBufferMessage\u003c/code\u003e, and \u003ccode\u003eIPageRequest\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eListEventsRequest\u003c/code\u003e class allows filtering of events by criteria such as category, state, update time, and impacted products, using the \u003ccode\u003eFilter\u003c/code\u003e property.\u003c/p\u003e\n"],["\u003cp\u003eThe class supports pagination, allowing the user to specify \u003ccode\u003ePageSize\u003c/code\u003e and \u003ccode\u003ePageToken\u003c/code\u003e to manage the amount of data that is returned, as well as retrieving the next page of results.\u003c/p\u003e\n"],["\u003cp\u003eIt has a \u003ccode\u003eParent\u003c/code\u003e property which is required and is used to specify the location and project for which to list service health events, which uses the format \u003ccode\u003eprojects/{project_id}/locations/{location}/events\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Service Health v1 API - Class ListEventsRequest (1.3.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.3.0 (latest)](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/latest/Google.Cloud.ServiceHealth.V1.ListEventsRequest)\n- [1.2.0](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/1.2.0/Google.Cloud.ServiceHealth.V1.ListEventsRequest)\n- [1.1.0](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/1.1.0/Google.Cloud.ServiceHealth.V1.ListEventsRequest)\n- [1.0.0](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/1.0.0/Google.Cloud.ServiceHealth.V1.ListEventsRequest) \n\n public sealed class ListEventsRequest : IMessage\u003cListEventsRequest\u003e, IEquatable\u003cListEventsRequest\u003e, IDeepCloneable\u003cListEventsRequest\u003e, IBufferMessage, IMessage, IPageRequest\n\nReference documentation and code samples for the Service Health v1 API class ListEventsRequest.\n\nMessage for requesting list of events. \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e ListEventsRequest \n\nImplements\n----------\n\n[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[ListEventsRequest](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/latest/Google.Cloud.ServiceHealth.V1.ListEventsRequest), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[ListEventsRequest](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/latest/Google.Cloud.ServiceHealth.V1.ListEventsRequest), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[ListEventsRequest](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/latest/Google.Cloud.ServiceHealth.V1.ListEventsRequest), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html), [IPageRequest](https://cloud.google.com/dotnet/docs/reference/Google.Api.Gax/latest/Google.Api.Gax.Grpc.IPageRequest.html) \n\nInherited Members\n-----------------\n\n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Cloud.ServiceHealth.V1](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/latest/Google.Cloud.ServiceHealth.V1)\n\nAssembly\n--------\n\nGoogle.Cloud.ServiceHealth.V1.dll\n\nConstructors\n------------\n\n### ListEventsRequest()\n\n public ListEventsRequest()\n\n### ListEventsRequest(ListEventsRequest)\n\n public ListEventsRequest(ListEventsRequest other)\n\nProperties\n----------\n\n### Filter\n\n public string Filter { get; set; }\n\nOptional. A filter expression that filters resources listed in the\nresponse. The expression takes the following forms: \\\u003cbr\\\u003e\n\n- field=value for `category` and `state`\\\u003cbr\\\u003e\n- field \\<, \\\u003e, \\<=, or \\\u003e= value for `update_time` \\\u003cbr\\\u003e Examples: `category=INCIDENT`, `update_time\u003e=\"2000-01-01T11:30:00-04:00\"`, `event_impacts.product.product_name:\"Eventarc\"` \\\u003cbr\\\u003e\n\nMultiple filter queries are separated by spaces. Example:\n`category=INCIDENT state=ACTIVE`.\n\nBy default, each expression is an AND expression. However, you can include\nAND and OR expressions explicitly.\n\nFilter is supported for the following fields: `category`, `state`,\n`update_time`, `event_impacts.product.product_name`\n\n### PageSize\n\n public int PageSize { get; set; }\n\nOptional. The maximum number of events that should be returned. Acceptable\nvalues are 1 to 100, inclusive. (The default value is 10.) If more results\nare available, the service returns a next_page_token that you can use to\nget the next page of results in subsequent list requests. The service may\nreturn fewer events than the requested page_size.\n\n### PageToken\n\n public string PageToken { get; set; }\n\nOptional. A token identifying a page of results the server should return.\nProvide Page token returned by a previous `ListEvents` call to retrieve the\nnext page of results. When paginating, all other parameters provided to\n`ListEvents` must match the call that provided the page token.\n\n### Parent\n\n public string Parent { get; set; }\n\nRequired. Parent value using the form\n`projects/{project_id}/locations/{location}/events`.\n\n`project_id` - ID of the project for which to list service health\nevents.\n`location` - The location to get the service health events from.\nTo retrieve service health events of category = INCIDENT, use `location` =\n`global`.\n\n### ParentAsLocationName\n\n public LocationName ParentAsLocationName { get; set; }\n\n[LocationName](https://cloud.google.com/dotnet/docs/reference/Google.Api.Gax/latest/Google.Api.Gax.ResourceNames.LocationName.html)-typed view over the [Parent](/dotnet/docs/reference/Google.Cloud.ServiceHealth.V1/latest/Google.Cloud.ServiceHealth.V1.ListEventsRequest#Google_Cloud_ServiceHealth_V1_ListEventsRequest_Parent) resource name property.\n\n### View\n\n public EventView View { get; set; }\n\nOptional. Event fields to include in response."]]
