audit-logs

List audit logs

Returns a list of audit log rows according to the query parameters. Note that this endpoint is paginated by default and the list is limited in results.

Pagination Upcloud-Total-Count header is included in the response to indicate the total number of audit logs available with the current query parameters (excluding limit and offset). The total count can be used for a number of pagination strategies. limit and offset query parameters can be used to finally paginate the results.

get/1.3/audit-logs

Request

Base URL: https://api.upcloud.com
URL: https://api.upcloud.com/1.3/audit-logs
Auth: HTTP bearer

Query parameters

qstring

Search string

Example:my_account

Filter audit logs using a keyword such as account username, resource ID or IP address.

limitinteger

Number of results to return

Example:50

Number of results to return (max 100, default 50)

offsetinteger

Page for retrieved results. Note: 0 and 1 retrieve the same first page results. (default 0)

Offset for retrieved results. (default 0)

actionsstring[]

List of actions to filter by

[
  "create",
  "update",
  "delete"
]

originsstring[]

List of origins to filter by

[
  "api",
  "gui"
]

resource_typesstring[]

List of resource types to filter by

[
  "server",
  "storage",
  "network"
]

created_afterstring date-time

List audit logs created after the given timestamp (including the time of timestamp). Format: ISO timestamp eg. 2024-01-01T23:45:56Z

Example:2024-01-01T00:00:00Z

created_beforestring date-time

List audit logs created before the given timestamp (including the time of timestamp). Format: ISO timestamp eg. 2024-01-01T23:45:56Z

Example:2024-12-31T23:59:59Z

Response

Successful response

Example response

{
  "audit_logs": []
}

Changes

No recorded changes to this operation across all 1 revision of this API.