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

Support EMS filters name endpoint overview

Contributors

Overview

Manages a specific filter instance. See the documentation for /support/ems/filters for details on the various fields.

Examples

Retrieving a specific filter instance

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

# Response
200 OK

# JSON Body
{
"name": "no-info-debug-events",
"rules": [
  {
    "index": 1,
    "type": "include",
    "message_criteria": {
      "name_pattern": "*",
      "severities": "emergency,alert,error,notice",
      "snmp_trap_types": "*",
      "_links": {
        "related": {
          "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"
      }
    }
  },
  {
    "index": 2,
    "type": "exclude",
    "message_criteria": {
      "name_pattern": "*",
      "severities": "*",
      "snmp_trap_types": "*",
      "_links": {
        "related": {
          "href": "/api/support/ems/messages?name=*&severity=*&snmp_trap_type=*"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/api/support/ems/filters/no-info-debug-events/rules/2"
      }
    }
  }
],
"_links": {
  "self": {
    "href": "/api/support/ems/filters/no-info-debug-events"
  }
}
}

Updating an existing filter with a new rule

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

# JSON Body
{
"rules": [
  {
    "type": "include",
    "message_criteria": {
      "name_pattern": "wafl.*",
      "severities": "error"
    }
  }
]
}

# Response
200 OK

Deleting an existing filter

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

# Response
200 OK