REST API Reference Version 5.2.1.0Search

Read

GET v1/events

Query parameters

Parameter Type
startRow NsUnsignedLong
endRow NsUnsignedLong
sortBy NsString
iSortBy NsString
pageSize NsUnsignedInt
id NsObjectID
type NsEventType
scope NsScope
target NsEventTargetName
target_type NsEventTargetType
timestamp NsTime
category NsEventCategory
severity NsSeverityLevel
summary NsString
activity NsAuditActivity
alarm_id NsObjectID

GET v1/events/detail

Query parameters

Parameter Type
startRow NsUnsignedLong
endRow NsUnsignedLong
sortBy NsString
iSortBy NsString
fields NsCommaSeparatedList
pageSize NsUnsignedInt
id NsObjectID
type NsEventType
scope NsScope
target NsEventTargetName
target_type NsEventTargetType
timestamp NsTime
category NsEventCategory
severity NsSeverityLevel
summary NsString
activity NsAuditActivity
alarm_id NsObjectID

GET v1/events/id

Query parameters

Parameter Type
fields NsCommaSeparatedList

Description

List a set of event records or a single event record.

Normal Response Codes

200 206

HTTP Error Codes

400 401 403 404 500 503

Response

Parameter Type JSON Type Description Deprecated
id NsObjectID string Identifier for the event record. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
type NsEventType number Type of the event record. Non-negative integer in range [0,2147483647].  
scope NsScope string The array name for array level event. Possible values: array serial number, or '-'. Example: 'AC-109084'.  
target NsEventTargetName string Name of object upon which the event occurred. String of up to 400 alphanumeric characters, - and . and : and " " are allowed after first character. Example: 'volumes in performance policy default'.  
target_type NsEventTargetType string enum Target type of the event record. Possible values: 'anon', 'array', 'controller', 'disk', 'nic', 'temperature', 'service', 'volume', 'protection_set', 'nvram', 'fan', 'power_supply', 'partner', 'raid', 'test', 'iscsi', 'pool', 'group', 'shelf', 'ntb', 'fc', 'initiator_group'.  
timestamp NsTime number Time when this event happened. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  
category NsEventCategory string enum Category of the event record. Possible values: 'unknown', 'hardware', 'service', 'replication', 'volume', 'update', 'configuration', 'test', 'security'.  
severity NsSeverityLevel string enum Severity level of the event. Possible values: 'info', 'notice', 'warning', 'critical'.  
summary NsString string Summary of the event. Plain string.  
activity NsAuditActivity string Description of the event. String of 1-1476 printable characters. Example: 'Created snapshot % of volume %'.  
alarm_id NsObjectID string The alarm ID if the event is related to an alarm. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  

JSON Response