Event Config Policy Tree
The API is used to fetch details of the event config policy and of the location on which the policy is created. It also provides details of the child locations inheriting the policy.
API Calls
/V7/configuration/locationbased/eventconfig/policytree
JSON Table
Attribute | Data Type | Description |
---|---|---|
type | String | The type of location on which the policy is created. The applicable values are:
|
id | application/json | Location identifier for the policy. The value is of the type Location Id json. |
name | String | Name of the location. |
accessibleToUser | boolean | A true or false value indicating whether the user has rights to access this location. |
timezoneId | int | The JAVA timezone ID of the location. |
locationTag | String | A user-defined tag for the location. |
children | application/json | A list of IDs of the child locations. The ID is a JSON object. |
children/type | String | Its the type of child location ID. The applicable values are:
The remotelocationid ID type is applicable only in cluster environments. |
children/id | int | The system-generated unique ID of the child location. |
children/name | String | Name of the child location. |
children/accessibleToUser | boolean | A true or false value indicating whether the user has rights to access this child location. |
children/timezoneId | int | The JAVA timezone ID of the child location. |
children/locationTag | String | A user-defined tag for the child location. |
children/children | application/json | A list of IDs of the child locations. The ID is a JSON object. |
children/policy | application/json | Details of the policy applied or inherited at the location. |
children/inherited | boolean | A true or false value indicating if the child has inherited the policy or not. |
policy | application/json | Details of the policy applied at the location. |
policy/policyCreatedAtLocId | application/json | The ID of the location at which the policy has been defined. For details about the JSON, click Location ID. |
policy/policyType | String | Type of the policy. Applicable value is EVENT_CONFIGURATION_POLICY. |
policy/eventTypes | application/json | A group of attributes related to event types. |
policy/eventTypes/majorType | String | The three broad categories of events. The applicable values are:
|
policy/eventTypes/category | int | The applicable values are:
|
policy/eventTypes/minorType | The minor type of event. | |
policy/eventTypes/minorTypeParams | ||
policy/eventTypes/minorTypeParams/configId | ||
policy/eventTypes/minorTypeParams/mncConfigId | ||
policy/eventTypes/minorTypeParams/modified | ||
policy/eventTypes/minorTypeParams/mncEventConfigOperation | ||
policy/eventTypes/minorTypeParams/minorTypeAttributeValues | ||
policy/eventTypes/minorTypeParams/minorTypeAttributeValues/minorTypeAttributeId | ||
policy/eventTypes/minorTypeParams/minorTypeAttributeValues/minorTypeAttributeValue | ||
policy/eventTypes/notify | boolean | A true or false value indicating whether external notifications must be sent if this type of event is raised. True indicates that the external notifications will be sent. |
policy/eventTypes/vulnerable | boolean | A true or false value indicating whether the event type will render the system vulnerable. True indicates that the event type will render the system vulnerable. |
policy/eventTypes/displayEvent | boolean | A true or false value indicating whether the event must be displayed in the event listing if this type of event is raised. True indicates that the event will be displayed in the event listing. |
policy/eventTypes/sendMail | boolean | A true or false value indicating whether an email should be sent if this type of event is raised. True indicates that an email will be sent if this type of event is raised. |
policy/eventTypes/severityLevel | String | The applicable values are:
|
inherited | boolean | A true or false value indicating whether the policy applied at the location is inherited or not. |
Sample JSON
{ "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 0 }, "name": "Locations", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [{ "type": "PolicyLocation", "id": { "type": "locallocationid", "id": -1 }, "name": "Unknown", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 3 }, "name": "America", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [{ "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 7 }, "name": "California", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 5 }, "name": "Chicago", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 6 }, "name": "Palo Alto", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true } ], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 2 }, "name": "Asia", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [{ "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 8 }, "name": "India", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [{ "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 10 }, "name": "Bangalore", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 11 }, "name": "Mumbai", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 9 }, "name": "Pune", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true } ], "policy": null, "inherited": true }], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 1 }, "name": "MSU Child", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 19 }, "name": "SwapnilD", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true }, { "type": "PolicyLocation", "id": { "type": "locallocationid", "id": 17 }, "name": "VijayP", "accessibleToUser": true, "timezoneId": "Asia/Kolkata", "locationTag": null, "children": [], "policy": null, "inherited": true } ], "policy": { "policyCreatedAtLocId": null, "policyType": "EVENT_CONFIGURATION_POLICY", "eventTypes": [{ "majorType": "WIFI", "category": 84, "minorType": 1013, "minorTypeParams": [{ "configId": 100, "mncConfigId": 0, "modified": false, "mncEventConfigOperation": null, "minorTypeAttributeValues": [{ "minorTypeAttributeId": "CLIENT_FAILURE_REASON", "minorTypeAttributeValue": "CLIENT_FAILURE_REASON_NETWORK" }, { "minorTypeAttributeId": "NO_OF_CLIENT_IN_FAILURE", "minorTypeAttributeValue": "3" } ] }, { "configId": 99, "mncConfigId": 0, "modified": false, "mncEventConfigOperation": null, "minorTypeAttributeValues": [{ "minorTypeAttributeId": "CLIENT_FAILURE_REASON", "minorTypeAttributeValue": "CLIENT_FAILURE_REASON_ASSOCIATION" }, { "minorTypeAttributeId": "NO_OF_CLIENT_IN_FAILURE", "minorTypeAttributeValue": "2" } ] } ], "notify": true, "vulnerable": false, "displayEvent": true, "sendMail": false, "severityLevel": "HIGH" }] }, "inherited": false }