Events:Get Audit Events

Search (SHIFT+S)




New in this release

Get Audit Events

GET /vdc/events

Gets audit events for the specified namespace identifier and interval.


Query Parameters

start_timestart time for the interval to retrieve audit events
end_timeend time for the interval to retrieve audit events
namespaceNamespace identifier for which audit events needs to be retrieved.
markerreference of last audit event returned
limitnumber of audit events requested in current fetch.

Required Roles

Requires one of the following roles:

  • SYSTEM_ADMIN

  • SYSTEM_MONITOR


Response Body

List of audit events for the given namespace identifier and interval

Field Description Type Notes
<auditevents>
<auditevent>     0-* Elements
<id> Event id String
<eventType> Event type String
<userId> User id for this event String
<serviceType> Service type String
<resourceId> Resource id String
<timestamp> Event creating time of yyyy-MM-dd'T'HH:mm format. String
<namespace> Namespace for this event String
<description> Description for this event String
</auditevent>      
<MaxEvents> Integer
<NextMarker> String
</auditevents>

Examples

Request
GET https://192.168.0.0:4443/vdc/events?start_time=2015-01-25T04:05&&end_time=2015-03-25T04:05&&namespace=s3&&limit=1 HTTP/1.1  

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK 
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<auditevents>
    <auditevent>
        <description>Bucket Created</description>
        <eventType>Created</eventType>
        <id>urn:storageos:Event:42a487a3-4071-4f76-ac82-f110ad4efd4a</id>
        <namespace>s3</namespace>
        <resourceId>s3.standalone-bucket</resourceId>
        <serviceType>Bucket</serviceType>
        <timestamp>2015-02-25T04:05</timestamp>
        <userId>wuser1@sanity.local</userId>
    </auditevent>
</auditevents>
Notes: