Correlation - Undeploy Correlation Rule

URI

https://164.99.19.131:8443/SentinelRESTServices/correlation/engines/{engineId}/rules/{ruleId}

Supported Methods

DELETE

This API undeploys the rule specified by {ruleId} deployed on the engine specified by {engineId}.

Authentication

Authentication Types
Sentinel Permissions Needed

URL Parameters

None.

Success Codes

Fault Codes

Request Data

Object type: Request object to deploy/undeploy/enable/disable a rule.
Both these fields are required to deploy/undeploy/enable/disable a rule
FieldRequiredDescription
engineIdtrueThis is the unique identifier of the Correlation engine.
ruleIdtrueThis is the unique identifier of the rule.

Response Data

Object type: Correlation rules object
All existing Correlation rules in the Sentinel system.
FieldDescription
activeThis is a Boolean value. If true, the rule is enabled and deployed, otherwise the rule is disabled. This is applicable only if the rule is deployed in a correlation engine.
deployedThis is Boolean value. If true, the rule is deployed into a correlation engine.
durationThe time duration within which the rule should fire.
engineIdThis is the unique ID of the Correlation engine where the rules are deployed. This is applicable only if the rule is deployed into a correlation engine.
healthThe health object of the rule. This is applicable if the rule is deployed into a correlation engine.
isGateThis is a Boolean value. If true, the rule is a composite rule. Otherwise, the rule is a sequence/simple rule.
offlineThis is a Boolean value. If true, the engine is in stopped or error state. This is applicable only if the rule is deployed into a correlation engine.
ruledescriptionThis is the description of the rule.
ruleIdThis is the unique identifier of the rule.
rulenameThis is the name of the rule.
rulesThe list of Correlation rule objects.
updatetimeThe time to initiate action execution when a rule fires.

Response Data

Object type: Correlation rule health object
Correlation rule health data.
FieldDescription
CardinalityThis is the health data of a rule. This indicates the number of strings and related structures held in memory by this rule. This is applicable only if the rule is deployed into a correlation engine.
EPSCapacityThis is the health data of a rule. This indicates the processing time the rule consumes relative to the capacity of the engine. This is applicable only if the rule is deployed into a correlation engine.
EventRefCountThis is the health data of a rule. This indicates the number of events held in memory by this rule. This is applicable only if the rule is deployed into a correlation engine.
FiredCountThis is the health data of a rule. This indicates the number of times the rule has fired since it was deployed. This is applicable only if the rule is deployed into a correlation engine.
LastFiredTimeThis is the health data of a rule. This indicates the last time (in milliseconds) the rule fired. This is applicable only if the rule is deployed into a correlation engine.
OutputRateThis is the health data of a rule. This indicates the number of times the rule has fired relative to the events processed. This is applicable only if the rule is deployed into a correlation engine.
StatusChangedTimeThis is the health data of a rule. This indicates the time (in milliseconds) the rule state was changed. This is applicable only if the rule is deployed into a correlation engine.
StatusDurationThis is the health data of a rule. This indicates the duration (in milliseconds) the rule is in its present state. This is applicable only if the rule is deployed into a correlation engine.
TotalProcessingTimeThis is the health data of a rule. This indicates the total time spent (in milliseconds) by the Correlation Engine processing the rule since it was deployed or enabled. This is applicable only if the rule is deployed into a correlation engine.

Sample Request

DELETE correlation/engines/696080E0-9A20-1029-ADDD-0003BAC9707D/rules/FE4BDFB0-9539-102E-98DA-000C29D8AA3D
Sample Response for application/json
Status: 200
{"rules":[{"ruleId":"3E285CF0-54B3-102B-B39D-00C09F472961","rulename":"Monitor Sentinel Core Solution Pack Controls","ruledescription":"This rule monitors the system to ensure that if any controls in this Solution Pack are uninstalled, security analysts are alerted.","isGate":"false","duration":"0","updatetime":"0","deployed":"true","engineId":"696080E0-9A20-1029-ADDD-0003BAC9707D","active":"true","offline":"false","health":{"FiredCount":"0","StatusDuration":"207894398","ProcessedCount":"6297","StatusChangedTime":"1316410548886","Cardinality":"0","EventRefCount":"0","LastFiredTime":"0","TotalProcessingTime":"1954","EPSCapacity":"9.0E-4","OutputRate":"0.0"}},{"ruleId":"1E6470B0-C4AF-102E-B507-0019B94687A1","rulename":"Multiple Password Change","ruledescription":"This is the scenario when same user logs in and changes the password more than 2 times ,this rule has to trigger.","isGate":"false","duration":"0","updatetime":"0","deployed":"true","engineId":"696080E0-9A20-1029-ADDD-0003BAC9707D","active":"true","offline":"false","health":{"FiredCount":"0","StatusDuration":"24469210","ProcessedCount":"776","StatusChangedTime":"1316593974074","Cardinality":"0","EventRefCount":"0","LastFiredTime":"0","TotalProcessingTime":"126","EPSCapacity":"5.0E-4","OutputRate":"0.0"}}]}