Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Modify an Advanced Incident Filter

 

Use this API to modify an advanced incident filter in Junos Space Service Now.

URI

https://[host]/api/juniper/servicenow/incident-filter-management/incidentFilters /{filterId}/modify (HTTP method = POST)

URI Parameters

Element

Type

Required

Description

filterId

Integer

Yes

ID of the incident filter to be modified

Consumes

  • application/vnd.juniper.servicenow.incident-filter-management.filter+xml; version=1;charset=UTF-8

  • application/vnd.juniper.servicenow.incident-filter-management.filter+json; version=1;charset=UTF-8

Request Elements

Element

Type

Description

name

String

Name of the filter

type

String

Type of the filter

Possible value—Advanced

action

String

Action to be taken on JMBs that match the filter condition and terms

Possible values:

  • CreateIncident

  • DoNotCreateIncident

termCriteria

String

Criterion for implementing the action defined in the filter

Possible values:

  • AND—The action defined in the filter is applied to an incident only when the JMB matches all the terms defined in the filter

  • OR—Action defined in the filter is applied to an incident when the JMB matches any term defined in the filter

advancedFilterAttribute

advancedFilterAttribute

Attributes defined in the filter

inputParams

String

Attribute based on which to filter JMB

perlFileContent

String

Encoded Perl script defining the filter logic

perlFileName

String

Name of the Perl file

Produces

  • application/vnd.juniper.servicenow.incident-filter-management.filter+xml;version=1

  • application/vnd.juniper.servicenow.incident-filter-management.filter+json;version=1

Response Elements

Element

Type

Description

uri

String

URI of the filter

id

Integer

ID of the filter

domainId

Integer

ID of the domain to which the filter is assigned

name

String

Name of the filter

type

String

Type of filter

Possible value—Advanced

action

String

Action to be taken on JMBs that match the filter condition and terms

Possible values:

  • CreateIncident

  • DoNotCreateIncident

createdBy

String

User who created the filter

priority

Integer

Order in which the filter is applied to JMBs

status

String

Status of the filter

Possible values:

  • Enabled—Filter can be applied to JMBs

  • Disabled—Filter cannot be applied to JMBs

advancedFilterAttribute

advancedFilterAttribute

Attributes of the filter

inputParams

String

Attribute based on which to filter JMB

Possible values—EventType, EventSynopsis, JunosOSVersion, Description, DeviceName, Platform, Entity, EventOccuredDate, DeviceIP

perlFileContent

String

Encoded Perl script defining the filter logic

perlFileName

String

Name of the Perl file

method

String

Methods applicable to the filter

Sample Input

Sample XML Input

Sample JSON Input

Sample Output

Sample XML Output

Sample JSON Output