Represents Rogue Access Point Alarms. It includes basic alarm attributes and additional details for Rogue AP alarms. Alarm is a representation of the fault or change of state that occurred in the managed system; it could be resource or service and customer related. Alarms are associated with a group of events received from the managed resources, usually with the same source and category, indicating that such fault or event had occurred.
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
Yes
|
Aggregation?
|
Yes
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
DevNet Discussions
API version v1 is deprecated
This API version has been deprecated. It will be removed in a future release of the product. Please develop new clients using the latest API version. Please modify your existing clients to use a later API version.
Resource URL
/webacs/api/v1/data/RogueApAlarms
To filter entities based on device groups, use Group Based Filtering as documented on the Filtering page on the Home page. Example: ?.group=myrouters
Deprecated
This version has been deprecated. Please use v4.
Response Parameters
acknowledgementStatus
boolean
|
Indicates whether the Alarm has been acknowledged.
|
alarmFoundAt
Date
|
Reflects the time when the Alarm was found.
|
alarmId
long
|
A calculated opaque value that is used by the event handling implementation logic to identify the alarm and that serves as an identifier (sometimes known as a "business key").
In most cases, the specific alarm ID is an identifier for the entity that caused the alarm (known as the "alarm source" and available in the "source" attribute) augmented by a distinguishing value (or values) to facilitate unique identifying value for this specific alarm. The distinguishing values can be, but are not limited to, the specific types of the alarm.
|
annotations
Annotation[]
|
This nested field contains corrective message annotations. These are notes added to the alarm by the operator.
|
creationTimestamp
Date
|
Specifies the time the note was created.
|
creatorId
String
|
Specifies the name or user id of the creator of this note.
|
noteText
String
|
Note content added by operator.
|
|
category
EventAlarmCategoryEnum
|
Specifies the major category for the Alarm/Event.
Categories are major functionality areas for events. For example, the wireless network management application categorizes events by the type of network element or entity that can emit them (access point, wireless LAN controller, port). A different application can introduce a different set of categories.
Binding the list of categories for a particular implementation is represented as a "Lookup" datatype for the values (as opposed to an immutable enumeration type).
|
condition
EventTypeEnum
|
Specifies a type of occurrence/event within a category.
Different applications can introduce different sets of types. Binding the list of types for a particular implementation is represented as a "Lookup" enumeration datatype for the values (as opposed to an immutable enumeration type).
|
deviceName
String
|
Represents the entity for which the event/alarm is reported.
|
deviceTimestamp
Date
|
Specifies the device clock time when this alarm was created.
|
lastUpdatedAt
Date
|
Reflects the time when the Alarm was last modified.
|
message
String
|
Contains the Event/Alarm description as free text.
|
nttyaddrss7_address
String
|
Used to associate AP alarms with their controller.
|
owner
String
|
Specifies the name or ID of the person assigned to handle this alarm. If value is set to NULL, no owner is assigned.
|
rogueApAlarmDetails
RogueApAlarmDetails
|
Rogue AP specific alarm details.
|
classificationType
RogueApClassificationTypeEnum
|
Rogue AP Classification Type.
Allowed values:
FRIENDLY
MALICIOUS
UNCLASSIFIED
CUSTOM
|
location
String
|
Indicates the map location for the Rogue Access Point.
|
macAddress
String
|
|
radioTypeDot11a
boolean
|
Indicates if Rogue Access Point supports 802.11a standard.
|
radioTypeDot11ac
boolean
|
Indicates if Rogue Access Point supports 802.11ac standard.
|
radioTypeDot11b
boolean
|
Indicates if Rogue Access Point supports 802.11b standard.
|
radioTypeDot11g
boolean
|
Indicates if Rogue Access Point supports 802.11g standard.
|
radioTypeDot11n2_4ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 2.4GHz standard.
|
radioTypeDot11n5ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 5GHz standard.
|
rogueClients
int
|
Count of Rogue Clients associated to the alarmed Access Point.
|
rssi
int
|
Indicates the strongest Received Signal Strength Indicator in dBm.
|
ssid
String
|
Service Set Identifier being broadcast by the Rogue Access Point Radio.
|
state
RogueApStateEnum
|
Indicates the state of the Rogue Access Point.
Allowed values:
INITIALIZING
PENDING
ALERT
AIRESPACE_AP
KNOWN
ACKNOWLEDGED
CONTAINED
THREAT
CONTAINED_PENDING
KNOWN_CONTAINED
TRUSTED_MISSING
REMOVED
WIRE_CONTAINED
|
|
severity
AlarmSeverityEnum
|
Specifies the Event/Alarm severity.
Allowed values:
CRITICAL
MAJOR
MINOR
WARNING
CLEARED
INFORMATION
|
source
String
|
Represents the entity for which the event/alarm is reported. This is not necessarily the reporting entity; in many cases, the notification is sent by an entity reporting an occurrence on another entity.
Note that this is an opaque reference type that MIGHT be a reference to a known entity (that is, an instance in the model), but it might also be a reference to an entity that is not represented in the system.
|
timeStamp
Date
|
Specifies the time when this alarm was created. This is the same as the time of the event that resulted in the creation of this alarm (attribute Event.notificationTimestamp).
|
wirelessSpecificAlarmId
String
|
Reports the MAC address of a rogue AP when a rogue AP is detected. Reports the wireless MAC address of an access point for all other alarms raised by an access point. Reports the controller IP address for alarms reported by a controller.
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://localhost/webacs/api/v1/data/RogueApAlarms/15
<?xml version="1.0" ?>
<queryResponse type="RogueApAlarms" responseType="getEntity" requestUrl="https://localhost/webacs/api/v1/data/RogueApAlarms/15" rootUrl="https://localhost/webacs/api/v1/data">
<entity dtoType="rogueApAlarmsDTO" type="RogueApAlarms" url="https://localhost/webacs/api/v1/data/RogueApAlarms/15">
<rogueApAlarmsDTO displayName="String value" id="15" uuid="String value">
<acknowledgementStatus>true</acknowledgementStatus>
<alarmFoundAt>2018-04-06T16:39:42.785Z</alarmFoundAt>
<alarmId>2</alarmId>
<annotations>
<annotation>
<creationTimestamp>2018-04-06T16:39:42.785Z</creationTimestamp>
<creatorId>String value</creatorId>
<noteText>String value</noteText>
</annotation>
</annotations>
<deviceName>String value</deviceName>
<deviceTimestamp>2018-04-06T16:39:42.788Z</deviceTimestamp>
<lastUpdatedAt>2018-04-06T16:39:42.788Z</lastUpdatedAt>
<message>String value</message>
<owner>String value</owner>
<severity>CRITICAL</severity>
<source>String value</source>
<timeStamp>2018-04-06T16:39:42.788Z</timeStamp>
<wirelessSpecificAlarmId>String value</wirelessSpecificAlarmId>
<nttyaddrss7_address>String value</nttyaddrss7_address>
<rogueApAlarmDetails>
<classificationType>FRIENDLY</classificationType>
<location>String value</location>
<radioTypeDot11a>true</radioTypeDot11a>
<radioTypeDot11ac>true</radioTypeDot11ac>
<radioTypeDot11b>true</radioTypeDot11b>
<radioTypeDot11g>true</radioTypeDot11g>
<radioTypeDot11n2_4ghz>true</radioTypeDot11n2_4ghz>
<radioTypeDot11n5ghz>true</radioTypeDot11n5ghz>
<rogueClients>1</rogueClients>
<rssi>1</rssi>
<ssid>String value</ssid>
<state>INITIALIZING</state>
<macAddress>String value</macAddress>
</rogueApAlarmDetails>
</rogueApAlarmsDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://localhost/webacs/api/v1/data/RogueApAlarms/15.json
{
"queryResponse" : {
"@type" : "RogueApAlarms",
"@responseType" : "getEntity",
"@requestUrl" : "https : \/\/localhost\/webacs\/api\/v1\/data\/RogueApAlarms\/15",
"@rootUrl" : "https : \/\/localhost\/webacs\/api\/v1\/data",
"entity" : {
"@dtoType" : "rogueApAlarmsDTO",
"@type" : "RogueApAlarms",
"@url" : "https : \/\/localhost\/webacs\/api\/v1\/data\/RogueApAlarms\/15",
"rogueApAlarmsDTO" : {
"@displayName" : "String value",
"@id" : "15",
"@uuid" : "String value",
"acknowledgementStatus" : true,
"alarmFoundAt" : "2018-04-06T16 : 39 : 42.785Z",
"alarmId" : 2,
"annotations" : {
"annotation" : {
"creationTimestamp" : "2018-04-06T16 : 39 : 42.785Z",
"creatorId" : "String value",
"noteText" : "String value"
}
},
"deviceName" : "String value",
"deviceTimestamp" : "2018-04-06T16 : 39 : 42.788Z",
"lastUpdatedAt" : "2018-04-06T16 : 39 : 42.788Z",
"message" : "String value",
"owner" : "String value",
"severity" : "CRITICAL",
"source" : "String value",
"timeStamp" : "2018-04-06T16 : 39 : 42.788Z",
"wirelessSpecificAlarmId" : "String value",
"nttyaddrss7_address" : "String value",
"rogueApAlarmDetails" : {
"classificationType" : "FRIENDLY",
"location" : "String value",
"radioTypeDot11a" : true,
"radioTypeDot11ac" : true,
"radioTypeDot11b" : true,
"radioTypeDot11g" : true,
"radioTypeDot11n2_4ghz" : true,
"radioTypeDot11n5ghz" : true,
"rogueClients" : 1,
"rssi" : 1,
"ssid" : "String value",
"state" : "INITIALIZING",
"macAddress" : "String value"
}
}
}
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
Yes
|
Aggregation?
|
Yes
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
DevNet Discussions
Resource URL
/webacs/api/v2/data/RogueApAlarms
To filter entities based on device groups, use Group Based Filtering as documented on the Filtering page on the Home page. Example: ?.group=myrouters
Unmodified
This resource has not been modified since the previous API version.
Deprecated
This version has been deprecated. Please use v4.
Response Parameters
acknowledgementStatus
boolean
|
Indicates whether the Alarm has been acknowledged.
|
alarmFoundAt
Date
|
Reflects the time when the Alarm was found.
|
alarmId
long
|
A calculated opaque value that is used by the event handling implementation logic to identify the alarm and that serves as an identifier (sometimes known as a "business key").
In most cases, the specific alarm ID is an identifier for the entity that caused the alarm (known as the "alarm source" and available in the "source" attribute) augmented by a distinguishing value (or values) to facilitate unique identifying value for this specific alarm. The distinguishing values can be, but are not limited to, the specific types of the alarm.
|
annotations
Annotation[]
|
This nested field contains corrective message annotations. These are notes added to the alarm by the operator.
|
creationTimestamp
Date
|
Specifies the time the note was created.
|
creatorId
String
|
Specifies the name or user id of the creator of this note.
|
noteText
String
|
Note content added by operator.
|
|
category
EventAlarmCategoryEnum
|
Specifies the major category for the Alarm/Event.
Categories are major functionality areas for events. For example, the wireless network management application categorizes events by the type of network element or entity that can emit them (access point, wireless LAN controller, port). A different application can introduce a different set of categories.
Binding the list of categories for a particular implementation is represented as a "Lookup" datatype for the values (as opposed to an immutable enumeration type).
|
condition
EventTypeEnum
|
Specifies a type of occurrence/event within a category.
Different applications can introduce different sets of types. Binding the list of types for a particular implementation is represented as a "Lookup" enumeration datatype for the values (as opposed to an immutable enumeration type).
|
deviceName
String
|
Represents the entity for which the event/alarm is reported.
|
deviceTimestamp
Date
|
Specifies the device clock time when this alarm was created.
|
lastUpdatedAt
Date
|
Reflects the time when the Alarm was last modified.
|
message
String
|
Contains the Event/Alarm description as free text.
|
nttyaddrss7_address
String
|
Used to associate AP alarms with their controller.
|
owner
String
|
Specifies the name or ID of the person assigned to handle this alarm. If value is set to NULL, no owner is assigned.
|
rogueApAlarmDetails
RogueApAlarmDetails
|
Rogue AP specific alarm details.
|
classificationType
RogueApClassificationTypeEnum
|
Rogue AP Classification Type.
Allowed values:
FRIENDLY
MALICIOUS
UNCLASSIFIED
CUSTOM
|
location
String
|
Indicates the map location for the Rogue Access Point.
|
macAddress
String
|
|
radioTypeDot11a
boolean
|
Indicates if Rogue Access Point supports 802.11a standard.
|
radioTypeDot11ac
boolean
|
Indicates if Rogue Access Point supports 802.11ac standard.
|
radioTypeDot11b
boolean
|
Indicates if Rogue Access Point supports 802.11b standard.
|
radioTypeDot11g
boolean
|
Indicates if Rogue Access Point supports 802.11g standard.
|
radioTypeDot11n2_4ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 2.4GHz standard.
|
radioTypeDot11n5ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 5GHz standard.
|
rogueClients
int
|
Count of Rogue Clients associated to the alarmed Access Point.
|
rssi
int
|
Indicates the strongest Received Signal Strength Indicator in dBm.
|
ssid
String
|
Service Set Identifier being broadcast by the Rogue Access Point Radio.
|
state
RogueApStateEnum
|
Indicates the state of the Rogue Access Point.
Allowed values:
INITIALIZING
PENDING
ALERT
AIRESPACE_AP
KNOWN
ACKNOWLEDGED
CONTAINED
THREAT
CONTAINED_PENDING
KNOWN_CONTAINED
TRUSTED_MISSING
REMOVED
WIRE_CONTAINED
|
|
severity
AlarmSeverityEnum
|
Specifies the Event/Alarm severity.
Allowed values:
CRITICAL
MAJOR
MINOR
WARNING
CLEARED
INFORMATION
|
source
String
|
Represents the entity for which the event/alarm is reported. This is not necessarily the reporting entity; in many cases, the notification is sent by an entity reporting an occurrence on another entity.
Note that this is an opaque reference type that MIGHT be a reference to a known entity (that is, an instance in the model), but it might also be a reference to an entity that is not represented in the system.
|
timeStamp
Date
|
Specifies the time when this alarm was created. This is the same as the time of the event that resulted in the creation of this alarm (attribute Event.notificationTimestamp).
|
wirelessSpecificAlarmId
String
|
Reports the MAC address of a rogue AP when a rogue AP is detected. Reports the wireless MAC address of an access point for all other alarms raised by an access point. Reports the controller IP address for alarms reported by a controller.
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://localhost/webacs/api/v2/data/RogueApAlarms/15
<?xml version="1.0" ?>
<queryResponse type="RogueApAlarms" responseType="getEntity" requestUrl="https://localhost/webacs/api/v2/data/RogueApAlarms/15" rootUrl="https://localhost/webacs/api/v2/data">
<entity dtoType="rogueApAlarmsDTO" type="RogueApAlarms" url="https://localhost/webacs/api/v2/data/RogueApAlarms/15">
<rogueApAlarmsDTO displayName="String value" id="15" uuid="String value">
<acknowledgementStatus>true</acknowledgementStatus>
<alarmFoundAt>2018-04-06T16:39:42.796Z</alarmFoundAt>
<alarmId>2</alarmId>
<annotations>
<annotation>
<creationTimestamp>2018-04-06T16:39:42.796Z</creationTimestamp>
<creatorId>String value</creatorId>
<noteText>String value</noteText>
</annotation>
</annotations>
<deviceName>String value</deviceName>
<deviceTimestamp>2018-04-06T16:39:42.799Z</deviceTimestamp>
<lastUpdatedAt>2018-04-06T16:39:42.799Z</lastUpdatedAt>
<message>String value</message>
<owner>String value</owner>
<severity>CRITICAL</severity>
<source>String value</source>
<timeStamp>2018-04-06T16:39:42.799Z</timeStamp>
<wirelessSpecificAlarmId>String value</wirelessSpecificAlarmId>
<nttyaddrss7_address>String value</nttyaddrss7_address>
<rogueApAlarmDetails>
<classificationType>FRIENDLY</classificationType>
<location>String value</location>
<radioTypeDot11a>true</radioTypeDot11a>
<radioTypeDot11ac>true</radioTypeDot11ac>
<radioTypeDot11b>true</radioTypeDot11b>
<radioTypeDot11g>true</radioTypeDot11g>
<radioTypeDot11n2_4ghz>true</radioTypeDot11n2_4ghz>
<radioTypeDot11n5ghz>true</radioTypeDot11n5ghz>
<rogueClients>1</rogueClients>
<rssi>1</rssi>
<ssid>String value</ssid>
<state>INITIALIZING</state>
<macAddress>String value</macAddress>
</rogueApAlarmDetails>
</rogueApAlarmsDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://localhost/webacs/api/v2/data/RogueApAlarms/15.json
{
"queryResponse" : {
"@type" : "RogueApAlarms",
"@requestUrl" : "https://localhost/webacs/api/v2/data/RogueApAlarms/15",
"@responseType" : "getEntity",
"@rootUrl" : "https://localhost/webacs/api/v2/data",
"entity" : [ {
"@dtoType" : "rogueApAlarmsDTO",
"@type" : "RogueApAlarms",
"@url" : "https://localhost/webacs/api/v2/data/RogueApAlarms/15",
"rogueApAlarmsDTO" : {
"@displayName" : "String value",
"@id" : 15,
"@uuid" : "String value",
"acknowledgementStatus" : true,
"alarmFoundAt" : 1523032782796,
"alarmId" : 2,
"annotations" : {
"annotation" : [ {
"creationTimestamp" : 1523032782796,
"creatorId" : "String value",
"noteText" : "String value"
} ]
},
"deviceName" : "String value",
"deviceTimestamp" : 1523032782799,
"lastUpdatedAt" : 1523032782799,
"message" : "String value",
"nttyaddrss7_address" : "String value",
"owner" : "String value",
"rogueApAlarmDetails" : {
"classificationType" : "FRIENDLY",
"location" : "String value",
"macAddress" : "String value",
"radioTypeDot11a" : true,
"radioTypeDot11ac" : true,
"radioTypeDot11b" : true,
"radioTypeDot11g" : true,
"radioTypeDot11n2_4ghz" : true,
"radioTypeDot11n5ghz" : true,
"rogueClients" : 1,
"rssi" : 1,
"ssid" : "String value",
"state" : "INITIALIZING"
},
"severity" : "CRITICAL",
"source" : "String value",
"timeStamp" : 1523032782799,
"wirelessSpecificAlarmId" : "String value"
}
} ]
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
Yes
|
Aggregation?
|
Yes
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
DevNet Discussions
Resource URL
/webacs/api/v3/data/RogueApAlarms
To filter entities based on device groups, use Group Based Filtering as documented on the Filtering page on the Home page. Example: ?.group=myrouters
Unmodified
This resource has not been modified since the previous API version.
Deprecated
This version has been deprecated. Please use v4.
Response Parameters
acknowledgementStatus
boolean
|
Indicates whether the Alarm has been acknowledged.
|
alarmFoundAt
Date
|
Reflects the time when the Alarm was found.
|
alarmId
long
|
A calculated opaque value that is used by the event handling implementation logic to identify the alarm and that serves as an identifier (sometimes known as a "business key").
In most cases, the specific alarm ID is an identifier for the entity that caused the alarm (known as the "alarm source" and available in the "source" attribute) augmented by a distinguishing value (or values) to facilitate unique identifying value for this specific alarm. The distinguishing values can be, but are not limited to, the specific types of the alarm.
|
annotations
Annotation[]
|
This nested field contains corrective message annotations. These are notes added to the alarm by the operator.
|
creationTimestamp
Date
|
Specifies the time the note was created.
|
creatorId
String
|
Specifies the name or user id of the creator of this note.
|
noteText
String
|
Note content added by operator.
|
|
category
EventAlarmCategoryEnum
|
Specifies the major category for the Alarm/Event.
Categories are major functionality areas for events. For example, the wireless network management application categorizes events by the type of network element or entity that can emit them (access point, wireless LAN controller, port). A different application can introduce a different set of categories.
Binding the list of categories for a particular implementation is represented as a "Lookup" datatype for the values (as opposed to an immutable enumeration type).
|
condition
EventTypeEnum
|
Specifies a type of occurrence/event within a category.
Different applications can introduce different sets of types. Binding the list of types for a particular implementation is represented as a "Lookup" enumeration datatype for the values (as opposed to an immutable enumeration type).
|
deviceName
String
|
Represents the entity for which the event/alarm is reported.
|
deviceTimestamp
Date
|
Specifies the device clock time when this alarm was created.
|
lastUpdatedAt
Date
|
Reflects the time when the Alarm was last modified.
|
message
String
|
Contains the Event/Alarm description as free text.
|
nttyaddrss7_address
String
|
Used to associate AP alarms with their controller.
|
owner
String
|
Specifies the name or ID of the person assigned to handle this alarm. If value is set to NULL, no owner is assigned.
|
rogueApAlarmDetails
RogueApAlarmDetails
|
Rogue AP specific alarm details.
|
classificationType
RogueApClassificationTypeEnum
|
Rogue AP Classification Type.
Allowed values:
FRIENDLY
MALICIOUS
UNCLASSIFIED
CUSTOM
|
location
String
|
Indicates the map location for the Rogue Access Point.
|
macAddress
String
|
|
radioTypeDot11a
boolean
|
Indicates if Rogue Access Point supports 802.11a standard.
|
radioTypeDot11ac
boolean
|
Indicates if Rogue Access Point supports 802.11ac standard.
|
radioTypeDot11b
boolean
|
Indicates if Rogue Access Point supports 802.11b standard.
|
radioTypeDot11g
boolean
|
Indicates if Rogue Access Point supports 802.11g standard.
|
radioTypeDot11n2_4ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 2.4GHz standard.
|
radioTypeDot11n5ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 5GHz standard.
|
rogueClients
int
|
Count of Rogue Clients associated to the alarmed Access Point.
|
rssi
int
|
Indicates the strongest Received Signal Strength Indicator in dBm.
|
ssid
String
|
Service Set Identifier being broadcast by the Rogue Access Point Radio.
|
state
RogueApStateEnum
|
Indicates the state of the Rogue Access Point.
Allowed values:
INITIALIZING
PENDING
ALERT
AIRESPACE_AP
KNOWN
ACKNOWLEDGED
CONTAINED
THREAT
CONTAINED_PENDING
KNOWN_CONTAINED
TRUSTED_MISSING
REMOVED
WIRE_CONTAINED
|
|
severity
AlarmSeverityEnum
|
Specifies the Event/Alarm severity.
Allowed values:
CRITICAL
MAJOR
MINOR
WARNING
CLEARED
INFORMATION
|
source
String
|
Represents the entity for which the event/alarm is reported. This is not necessarily the reporting entity; in many cases, the notification is sent by an entity reporting an occurrence on another entity.
Note that this is an opaque reference type that MIGHT be a reference to a known entity (that is, an instance in the model), but it might also be a reference to an entity that is not represented in the system.
|
timeStamp
Date
|
Specifies the time when this alarm was created. This is the same as the time of the event that resulted in the creation of this alarm (attribute Event.notificationTimestamp).
|
wirelessSpecificAlarmId
String
|
Reports the MAC address of a rogue AP when a rogue AP is detected. Reports the wireless MAC address of an access point for all other alarms raised by an access point. Reports the controller IP address for alarms reported by a controller.
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://localhost/webacs/api/v3/data/RogueApAlarms/15
<?xml version="1.0" ?>
<queryResponse type="RogueApAlarms" responseType="getEntity" requestUrl="https://localhost/webacs/api/v3/data/RogueApAlarms/15" rootUrl="https://localhost/webacs/api/v3/data">
<entity dtoType="rogueApAlarmsDTO" type="RogueApAlarms" url="https://localhost/webacs/api/v3/data/RogueApAlarms/15">
<rogueApAlarmsDTO displayName="String value" id="15" uuid="String value">
<acknowledgementStatus>true</acknowledgementStatus>
<alarmFoundAt>2018-04-06T16:39:42.802Z</alarmFoundAt>
<alarmId>2</alarmId>
<annotations>
<annotation>
<creationTimestamp>2018-04-06T16:39:42.802Z</creationTimestamp>
<creatorId>String value</creatorId>
<noteText>String value</noteText>
</annotation>
<annotation>
<creationTimestamp>2018-04-05T16:39:42.802Z</creationTimestamp>
<creatorId>Another string value</creatorId>
<noteText>Another string value</noteText>
</annotation>
</annotations>
<deviceName>String value</deviceName>
<deviceTimestamp>2018-04-06T16:39:42.805Z</deviceTimestamp>
<lastUpdatedAt>2018-04-06T16:39:42.805Z</lastUpdatedAt>
<message>String value</message>
<owner>String value</owner>
<severity>CRITICAL</severity>
<source>String value</source>
<timeStamp>2018-04-06T16:39:42.805Z</timeStamp>
<wirelessSpecificAlarmId>String value</wirelessSpecificAlarmId>
<nttyaddrss7_address>String value</nttyaddrss7_address>
<rogueApAlarmDetails>
<classificationType>FRIENDLY</classificationType>
<location>String value</location>
<radioTypeDot11a>true</radioTypeDot11a>
<radioTypeDot11ac>true</radioTypeDot11ac>
<radioTypeDot11b>true</radioTypeDot11b>
<radioTypeDot11g>true</radioTypeDot11g>
<radioTypeDot11n2_4ghz>true</radioTypeDot11n2_4ghz>
<radioTypeDot11n5ghz>true</radioTypeDot11n5ghz>
<rogueClients>1</rogueClients>
<rssi>1</rssi>
<ssid>String value</ssid>
<state>INITIALIZING</state>
<macAddress>String value</macAddress>
</rogueApAlarmDetails>
</rogueApAlarmsDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://localhost/webacs/api/v3/data/RogueApAlarms/15.json
{
"queryResponse" : {
"@type" : "RogueApAlarms",
"@requestUrl" : "https://localhost/webacs/api/v3/data/RogueApAlarms/15",
"@responseType" : "getEntity",
"@rootUrl" : "https://localhost/webacs/api/v3/data",
"entity" : [ {
"@dtoType" : "rogueApAlarmsDTO",
"@type" : "RogueApAlarms",
"@url" : "https://localhost/webacs/api/v3/data/RogueApAlarms/15",
"rogueApAlarmsDTO" : {
"@displayName" : "String value",
"@id" : 15,
"@uuid" : "String value",
"acknowledgementStatus" : true,
"alarmFoundAt" : "2018-04-06T16:39:42.802Z",
"alarmId" : 2,
"annotations" : {
"annotation" : [ {
"creationTimestamp" : "2018-04-06T16:39:42.802Z",
"creatorId" : "String value",
"noteText" : "String value"
}, {
"creationTimestamp" : "2018-04-05T16:39:42.802Z",
"creatorId" : "Another string value",
"noteText" : "Another string value"
} ]
},
"deviceName" : "String value",
"deviceTimestamp" : "2018-04-06T16:39:42.805Z",
"lastUpdatedAt" : "2018-04-06T16:39:42.805Z",
"message" : "String value",
"nttyaddrss7_address" : "String value",
"owner" : "String value",
"rogueApAlarmDetails" : {
"classificationType" : "FRIENDLY",
"location" : "String value",
"macAddress" : "String value",
"radioTypeDot11a" : true,
"radioTypeDot11ac" : true,
"radioTypeDot11b" : true,
"radioTypeDot11g" : true,
"radioTypeDot11n2_4ghz" : true,
"radioTypeDot11n5ghz" : true,
"rogueClients" : 1,
"rssi" : 1,
"ssid" : "String value",
"state" : "INITIALIZING"
},
"severity" : "CRITICAL",
"source" : "String value",
"timeStamp" : "2018-04-06T16:39:42.805Z",
"wirelessSpecificAlarmId" : "String value"
}
} ]
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
Yes
|
Aggregation?
|
Yes
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
DevNet Discussions
Resource URL
/webacs/api/v4/data/RogueApAlarms
To filter entities based on device groups, use Group Based Filtering as documented on the Filtering page on the Home page. Example: ?.group=myrouters
Updated
Since version 4 type of nttyaddrss7_address is InetAddress.
Response Parameters
acknowledgementStatus
boolean
|
Indicates whether the Alarm has been acknowledged.
|
alarmFoundAt
Date
|
Reflects the time when the Alarm was found.
|
alarmId
long
|
A calculated opaque value that is used by the event handling implementation logic to identify the alarm and that serves as an identifier (sometimes known as a "business key").
In most cases, the specific alarm ID is an identifier for the entity that caused the alarm (known as the "alarm source" and available in the "source" attribute) augmented by a distinguishing value (or values) to facilitate unique identifying value for this specific alarm. The distinguishing values can be, but are not limited to, the specific types of the alarm.
|
annotations
Annotation[]
|
This nested field contains corrective message annotations. These are notes added to the alarm by the operator.
|
creationTimestamp
Date
|
Specifies the time the note was created.
|
creatorId
String
|
Specifies the name or user id of the creator of this note.
|
noteText
String
|
Note content added by operator.
|
|
category
EventAlarmCategoryEnum
|
Specifies the major category for the Alarm/Event.
Categories are major functionality areas for events. For example, the wireless network management application categorizes events by the type of network element or entity that can emit them (access point, wireless LAN controller, port). A different application can introduce a different set of categories.
Binding the list of categories for a particular implementation is represented as a "Lookup" datatype for the values (as opposed to an immutable enumeration type).
|
condition
EventTypeEnum
|
Specifies a type of occurrence/event within a category.
Different applications can introduce different sets of types. Binding the list of types for a particular implementation is represented as a "Lookup" enumeration datatype for the values (as opposed to an immutable enumeration type).
|
deviceName
String
|
Represents the entity for which the event/alarm is reported.
|
deviceTimestamp
Date
|
Specifies the device clock time when this alarm was created.
|
lastUpdatedAt
Date
|
Reflects the time when the Alarm was last modified.
|
message
String
|
Contains the Event/Alarm description as free text.
|
nttyaddrss7_address
InetAddress
|
Used to associate AP alarms with their controller.
|
owner
String
|
Specifies the name or ID of the person assigned to handle this alarm. If value is set to NULL, no owner is assigned.
|
rogueApAlarmDetails
RogueApAlarmDetailsV4
|
Rogue AP specific alarm details.
|
classificationType
RogueApClassificationTypeEnum
|
Rogue AP Classification Type.
Allowed values:
FRIENDLY
MALICIOUS
UNCLASSIFIED
CUSTOM
|
location
String
|
Indicates the map location for the Rogue Access Point.
|
macAddress
MacAddress
|
|
radioTypeDot11a
boolean
|
Indicates if Rogue Access Point supports 802.11a standard.
|
radioTypeDot11ac
boolean
|
Indicates if Rogue Access Point supports 802.11ac standard.
|
radioTypeDot11b
boolean
|
Indicates if Rogue Access Point supports 802.11b standard.
|
radioTypeDot11g
boolean
|
Indicates if Rogue Access Point supports 802.11g standard.
|
radioTypeDot11n2_4ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 2.4GHz standard.
|
radioTypeDot11n5ghz
boolean
|
Indicates if Rogue Access Point supports 802.11n 5GHz standard.
|
rogueClients
int
|
Count of Rogue Clients associated to the alarmed Access Point.
|
rssi
int
|
Indicates the strongest Received Signal Strength Indicator in dBm.
|
ssid
String
|
Service Set Identifier being broadcast by the Rogue Access Point Radio.
|
state
RogueApStateEnum
|
Indicates the state of the Rogue Access Point.
Allowed values:
INITIALIZING
PENDING
ALERT
AIRESPACE_AP
KNOWN
ACKNOWLEDGED
CONTAINED
THREAT
CONTAINED_PENDING
KNOWN_CONTAINED
TRUSTED_MISSING
REMOVED
WIRE_CONTAINED
|
|
severity
AlarmSeverityEnum
|
Specifies the Event/Alarm severity.
Allowed values:
CRITICAL
MAJOR
MINOR
WARNING
CLEARED
INFORMATION
|
source
String
|
Represents the entity for which the event/alarm is reported. This is not necessarily the reporting entity; in many cases, the notification is sent by an entity reporting an occurrence on another entity.
Note that this is an opaque reference type that MIGHT be a reference to a known entity (that is, an instance in the model), but it might also be a reference to an entity that is not represented in the system.
|
timeStamp
Date
|
Specifies the time when this alarm was created. This is the same as the time of the event that resulted in the creation of this alarm (attribute Event.notificationTimestamp).
|
wirelessSpecificAlarmId
String
|
Reports the MAC address of a rogue AP when a rogue AP is detected. Reports the wireless MAC address of an access point for all other alarms raised by an access point. Reports the controller IP address for alarms reported by a controller.
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://localhost/webacs/api/v4/data/RogueApAlarms/15
<?xml version="1.0" ?>
<queryResponse type="RogueApAlarms" responseType="getEntity" requestUrl="https://localhost/webacs/api/v4/data/RogueApAlarms/15" rootUrl="https://localhost/webacs/api/v4/data">
<entity dtoType="rogueApAlarmsDTO" type="RogueApAlarms" url="https://localhost/webacs/api/v4/data/RogueApAlarms/15">
<rogueApAlarmsDTO displayName="String value" id="15" uuid="String value">
<acknowledgementStatus>true</acknowledgementStatus>
<alarmFoundAt>2018-04-06T16:39:42.808Z</alarmFoundAt>
<alarmId>2</alarmId>
<annotations>
<annotation>
<creationTimestamp>2018-04-06T16:39:42.808Z</creationTimestamp>
<creatorId>String value</creatorId>
<noteText>String value</noteText>
</annotation>
<annotation>
<creationTimestamp>2018-04-05T16:39:42.808Z</creationTimestamp>
<creatorId>Another string value</creatorId>
<noteText>Another string value</noteText>
</annotation>
</annotations>
<deviceName>String value</deviceName>
<deviceTimestamp>2018-04-06T16:39:42.811Z</deviceTimestamp>
<lastUpdatedAt>2018-04-06T16:39:42.811Z</lastUpdatedAt>
<message>String value</message>
<owner>String value</owner>
<severity>CRITICAL</severity>
<source>String value</source>
<timeStamp>2018-04-06T16:39:42.812Z</timeStamp>
<wirelessSpecificAlarmId>String value</wirelessSpecificAlarmId>
<nttyaddrss7_address>
<address>192.168.115.243</address>
</nttyaddrss7_address>
<rogueApAlarmDetails>
<classificationType>FRIENDLY</classificationType>
<location>String value</location>
<radioTypeDot11a>true</radioTypeDot11a>
<radioTypeDot11ac>true</radioTypeDot11ac>
<radioTypeDot11b>true</radioTypeDot11b>
<radioTypeDot11g>true</radioTypeDot11g>
<radioTypeDot11n2_4ghz>true</radioTypeDot11n2_4ghz>
<radioTypeDot11n5ghz>true</radioTypeDot11n5ghz>
<rogueClients>1</rogueClients>
<rssi>1</rssi>
<ssid>String value</ssid>
<state>INITIALIZING</state>
<macAddress>
<octets>000a959d6816</octets>
</macAddress>
</rogueApAlarmDetails>
</rogueApAlarmsDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://localhost/webacs/api/v4/data/RogueApAlarms/15.json
{
"queryResponse" : {
"@type" : "RogueApAlarms",
"@requestUrl" : "https://localhost/webacs/api/v4/data/RogueApAlarms/15",
"@responseType" : "getEntity",
"@rootUrl" : "https://localhost/webacs/api/v4/data",
"entity" : [ {
"@dtoType" : "rogueApAlarmsDTO",
"@type" : "RogueApAlarms",
"@url" : "https://localhost/webacs/api/v4/data/RogueApAlarms/15",
"rogueApAlarmsDTO" : {
"@displayName" : "String value",
"@id" : 15,
"@uuid" : "String value",
"acknowledgementStatus" : true,
"alarmFoundAt" : "2018-04-06T16:39:42.808Z",
"alarmId" : 2,
"annotations" : {
"annotation" : [ {
"creationTimestamp" : "2018-04-06T16:39:42.808Z",
"creatorId" : "String value",
"noteText" : "String value"
}, {
"creationTimestamp" : "2018-04-05T16:39:42.808Z",
"creatorId" : "Another string value",
"noteText" : "Another string value"
} ]
},
"deviceName" : "String value",
"deviceTimestamp" : "2018-04-06T16:39:42.811Z",
"lastUpdatedAt" : "2018-04-06T16:39:42.811Z",
"message" : "String value",
"nttyaddrss7_address" : {
"address" : "192.168.115.243"
},
"owner" : "String value",
"rogueApAlarmDetails" : {
"classificationType" : "FRIENDLY",
"location" : "String value",
"macAddress" : {
"octets" : "000a959d6816"
},
"radioTypeDot11a" : true,
"radioTypeDot11ac" : true,
"radioTypeDot11b" : true,
"radioTypeDot11g" : true,
"radioTypeDot11n2_4ghz" : true,
"radioTypeDot11n5ghz" : true,
"rogueClients" : 1,
"rssi" : 1,
"ssid" : "String value",
"state" : "INITIALIZING"
},
"severity" : "CRITICAL",
"source" : "String value",
"timeStamp" : "2018-04-06T16:39:42.812Z",
"wirelessSpecificAlarmId" : "String value"
}
} ]
}
}