Events:Get Audit Events

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

Get Audit Events

GET /vdc/events

Gets audit events for the specified namespace identifier and interval.

Query Parameters

start_time	start time for the interval to retrieve audit events
end_time	end time for the interval to retrieve audit events
namespace	Namespace identifier for which audit events needs to be retrieved.
marker	reference of last audit event returned
limit	number 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
MaxEvents		Integer
NextMarker		String

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>

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/json
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP/1.1 200 OK
Content-Type: application/json  

{
    "auditevent": [
        {
            "id": "urn:storageos:Event:42a487a3-4071-4f76-ac82-f110ad4efd4a",
            "eventType": "Created",
            "userId": "wuser1@sanity.local",
            "serviceType": "Bucket",
            "resourceId": "s3.standalone-bucket",
            "timestamp": "2015-02-25T04:05",
            "namespace": "s3",
            "description": "Bucket Created"
        }
    ]
}

Request

curl -H $token -H "Content-Type: application/xml" -X GET https://$nodeIp:4443/vdc/events?start_time=2015-01-25T04:05&end_time=2015-03-25T04:05&namespace=s3&limit=1

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>