PUT /events/exclusionfilters

Use the PUT method to modify event exclusion filters after they are configured without requiring that they be deleted and re-added. When editing an exclusion filter, the ID of the updated exclusion filter is included in the response.

All attributes in the exclusion filter can be changed. For example, a monitor could be temporarily disabled and then enabled again at a later time.

Authentication

Authentication with user name and password is required.

Request URL

PUT https://<management_server_IP>/events/exclusionfilters

Query parameters

None

Request body

Attributes Required / Optional Type Definition
description Optional String Optional description for the exclusion filter
eventFilter Required Array Event filter information
  fields Optional Object Fields to filter on and the associated REGEX string to filter. The event field must match one of the supported fields in the event class (see Filtering events).
  filterType Optional String Type of filter. This can be one of the following values:
  • FIELDREGEXAND. Event filter matches only if all fields find a match with the given field REGEX.
  • FIELDREGEXOR. Event filter matches if any field finds a match with the given field REGEX.
  • FIELDREGEXNOT. Event filter matches only if all fields do not find a match with the given field REGEX.
id Required String Unique ID assigned to the exclusion filter when it is configured
name Required String User-defined name for the exclusion filter. This must be unique for all monitors.
state Optional String Current state of the exclusion filter. This can be one of the following values.
  • disabled
  • enabled
type Required String Event type. This can be one of the following values.
  • activeAlert
  • event

Response codes

Code Description
200 OK
400 Bad request
401 Unauthorized
500 Internal server error

Response body

If successful, response includes a JSON object that contains the ID for the exclusion filter along with other optional attributes.