CHchaos-mesh
events

list a page of events.

Changed on

Returns a paginated event object. Page is one-based and required, with 12 rows by default and a maximum of 1000. Repeated namespace/name/kind/object_id values are ORed within each field; fields and inclusive time bounds are ANDed. Time bounds accept RFC3339 timestamps. Comparison precision depends on the database. Sort ties use ID in the same direction. next_page is null when there are no more events. include_total=true additionally returns total and total_pages, with total_pages=0 for no matches. Count and page can change under concurrent writes; separate requests are not a fixed snapshot.

get/events/page

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    none declared

Query parameters

created_atstring

Deprecated, ignored; use start and end

namestring[]

Object names

namespacestring[]

Object namespaces; every namespace must be authorized

object_idstring[]

Object UIDs

kindstring[]

Object kinds

startstring

Inclusive creation time lower bound (RFC3339)

endstring

Inclusive creation time upper bound (RFC3339)

pageinteger required

Page number; one-based

limitinteger

Maximum rows, default 12

include_totalboolean

Include total and total_pages

sort'id' | 'object_id' | 'namespace' | 'name' | 'kind' | 'created_at' | 'message'

Sort field, default id

order'asc' | 'desc'

Sort direction, default desc

Response

OK

limitinteger required
next_pageinteger nullable required
pageinteger required
totalinteger
total_pagesinteger

Changes