Skip to main content
A newer release of this product is available.

Support EMS filters name rules index endpoint overview

Contributors

Overview

Manages a specific instance of a rule within a filter. See the documentation for /support/ems/filters for details on the various properties in a rule.

Examples

Retrieving a single instance of a rule

# API
GET /api/support/ems/filters/no-info-debug-events/rules/1

# Response
200 OK

# JSON Body
{
"name": "no-info-debug-events",
"index": 1,
"type": "include",
"message_criteria": {
  "name_pattern": "*",
  "severities": "emergency,alert,error,notice",
  "snmp_trap_types": "*",
  "_links": {
    "self": {
      "href": "/api/support/ems/messages?name=*&severity=emergency,alert,error,notice&snmp_trap_type=*"
    }
  }
},
"_links": {
  "self": {
    "href": "/api/support/ems/filters/no-info-debug-events/rules/1"
  }
}
}

Updating an existing rule to use severity emergency

# API
PATCH /api/support/ems/filters/test-filter/rules/1

# JSON Body
{
"message_criteria": {
  "severities": "emergency"
}
}

# Response
200 OK

Deleting a rule from an existing filter

# API
DELETE /api/support/ems/filters/test-filter/rules/1

# Response
200 OK