audit-events/type/{type}

Details for an event type that the policy console is tracking.

GET

Returns details for all events of a specific type that the policy console is tracking. The valid types of events are changes to the policy configuration for an app or the securing of an app. Optionally, you can limit the number of events to display on a page or specify which event to start displaying on a page.

Parameters

Parameter

Description

type

Required. The type of event to report.

2: Policy configuration system events.
3: App securing system events.
4: SmartLink configuration download events.
5: App upload events.

start

Optional. The first event in the result set to return.

Valid value: an integer. Default: 0.

limit

Optional. Maximum number of events of a specific type to display on a page.

Valid value: an integer. Default: 10

Example request

This request returns all events of the type that involve app-securing, starting at the 2nd record of an event with a limit of 3 events displayed per page.

Request

CODE

curl -b c.txt -c c.txt -X GET \
https://bc.qwe.com/mocana-app-control/rest/audit-events/type/3?start=1&limit=3

Response

CODE

{
  "audit_events": {
    "events_limit": 3,
    "events_list": [
      {
        "action": "Secured app [com.mocana.Compass] [PLATFORM_IOS].",
        "addr": "10.42.18.106",
        "date": "2017-06-20 10:50:22.0",
        "event_id": "3c7e2301-902d-4215-a588-d05eeb767c51",
        "info_url": "https://bc.qwe.com/mocana-app-control/rest/audit-events/3c7e2301-902d-4215-a588-d05eeb767c51",
        "type": 3,
        "user": "email01@qwe.com"
      },
      {
        "action": "Secured app [com.mocana.Compass] [PLATFORM_IOS].",
        "addr": "10.42.18.102",
        "date": "2017-06-20 10:14:36.0",
        "event_id": "60a91c30-df00-4c9e-984f-a3e2aedb4e69",
        "info_url": "https://bc.qwe.com/mocana-app-control/rest/audit-events/60a91c30-df00-4c9e-984f-a3e2aedb4e69",
        "type": 3,
        "user": "email01@qwe.com"
      },
      {
        "action": "Secured app [com.mocana.Compass] [PLATFORM_IOS].",
        "addr": "10.42.18.102",
        "date": "2017-06-20 10:13:52.0",
        "event_id": "0752436f-20f4-4112-9fc1-bf3463a073a5",
        "info_url": "https://bc.qwe.com/mocana-app-control/rest/audit-events/0752436f-20f4-4112-9fc1-bf3463a073a5",
        "type": 3,
        "user": "email01@qwe.com"
      }
    ],
    "events_start": 1,
    "events_total": 402,
    "events_type": 3
  },
  "message": "",
  "status": "OK"
}