Audit logs

Auditlog

List audit log entries

Sample request 

List the audit log:

GET /sdn/v2.0/auditlog

List the audit log by user:

GET /sdn/v2.0/auditlog?user="john.doe"

List the audit log by activity:

GET /sdn/v2.0/auditlog?activity="suspicious"

List the audit log by time period:

GET /sdn/v2.0/auditlog?start=2013-09-19T18%3A06%3A54.086Z&end=2013-09-19T18%3A06%3A54.108Z
Parameters:

user ... optional; if specified, returns only the audit logs for the specified user; otherwise a wildcard

activity... optional; if specified returns only the audit logs with the specified activity; otherwise a wildcard

start... optional; the inclusive start date of the requested time period in ISO-8601 format (Example: 2013-09-15T16:00:00.000Z)

end... optional; the inclusive end date of the requested time period in ISO-8601 format (Example: 2013-09-15T16:00:00.000Z)

There is no request body for this API.

Sample response 

{
   "audit_log_entries":[
      {
         "uid":"730d99ee-78f9-4301-ab2b-7871df61a6d3",
         "system_uid":"a1adf6a0-13d3-45de-bf66-acc504e84dba",
         "user":"sdn",
         "ts":"2013-06-05T17:54:19.265Z",
         "activity":"Artifact Management - Upload",
         "description":"geewiz-apps-1.0.0.jar has been staged"
      },
      {
         "uid":"77881f9f-a0c4-482b-8fd2-872c87c1bcab",
         "system_uid":"a1adf6a0-13d3-45de-bf66-acc504e84dba",
         "user":"sdn",
         "ts":"2013-06-05T17:54:19.754Z",
         "activity":"Artifact Management - Refresh",
         "description":"com.geewiz.apps has been refreshed"
      },
      {
         "uid":"a39fdb1d-a0f2-444b-b79a-ada13cf0dc0b",
         "system_uid":"a1adf6a0-13d3-45de-bf66-acc504e84dba",
         "user":"sdn",
         "ts":"2013-06-05T17:54:20.312Z",
         "activity":"Artifact Management - Uninstall",
         "description":"com.geewiz.apps has been removed"
      },
      {
         "uid":"003e52ec-4bce-47c5-b3ec-cf6163aca5c0",
         "system_uid":"a1adf6a0-13d3-45de-bf66-acc504e84dba",
         "user":"sdn",
         "ts":"2013-06-05T17:54:20.975Z",
         "activity":"Artifact Management - Upload",
         "description":"golly-gee-app.zip has been staged"
      },
      {
         "uid":"98a92ddf-04ad-474e-9c6a-fa99ff7256ed",
         "system_uid":"a1adf6a0-13d3-45de-bf66-acc504e84dba",
         "user":"sdn",
         "ts":"2013-06-05T17:54:24.165Z",
         "activity":"Artifact Management - Refresh",
         "description":"golly-gee.plan has been refreshed"
      },
      {
         "uid":"21f082f5-8b1b-453a-8474-a3e1eab4e0ef",
         "system_uid":"a1adf6a0-13d3-45de-bf66-acc504e84dba",
         "user":"sdn",
         "ts":"2013-06-05T17:54:26.028Z",
         "activity":"Artifact Management - Uninstall",
         "description":"golly-gee.plan has been removed"
      }
   ]
}

Response codes 

  • Normal: OK (200)

  • Error: Unauthorized (401), Not Found (404), Service Unavailable (503)