Add Search Based Alert Config

Add a new Search Based Alert Configuration (User Defined Alert Configuration).

Request

URI

POST

https://{api_host}/api/ni/settings/alerts/search-based-alerts

COPY

Request Body

Add a new Search Based Alert Configuration

SearchBasedAlertConfigRequest of type(s) application/json

Required

{
    "alert_name": "string",
    "search_criteria": "string",
    "generate_alert_criteria": "string",
    "alert_type": "string",
    "severity": "string",
    "notification_settings": [
        {
            "type": "string",
            "frequency": "string",
            "notification_time": "string",
            "receivers": [
                "string"
            ],
            "enabled": false
        }
    ]
}

string

alert_name

Optional

Name of the Search based Alert Configuration.

string

search_criteria

Optional

The search query for the search-based alert configuration.

GenerateEventCritera

generate_alert_criteria

Optional

The basis of raising of alerts. It can take a value SEARCH_RESULT_CHANGE or ZERO_SEARCH_RESULTS

Possible values are : SEARCH_RESULT_CHANGE, ZERO_SEARCH_RESULTS,

AlertType

alert_type

Optional

The type of alert. It can take a value PROBLEM or CHANGE.

Possible values are : PROBLEM, CHANGE, INTENT,

Severity

severity

Optional

severity

Possible values are : Critical, Moderate, Warning, Info,

array of NotificationSetting

notification_settings

Optional

Notifications configured for alerts corresponding to this alert configuration.

Authentication

This operation uses the following authentication methods.

ApiKeyAuth

Responses

201

Success

Returns SearchBasedAlertConfigResponse of type(s) application/json

{
    "entity_id": "string",
    "alert_name": "string",
    "enabled": false,
    "search_criteria": "string",
    "generate_alert_criteria": "string",
    "alert_type": "string",
    "severity": "string",
    "notification_settings": [
        {
            "type": "string",
            "frequency": "string",
            "notification_time": "string",
            "receivers": [
                "string"
            ],
            "enabled": false
        }
    ]
}

string

entity_id

Optional

entity_id

string

alert_name

Optional

Name of the Search based Alert Configuration.

boolean

enabled

Optional

Boolean value to depict if the Search based alert configuration is enabled.

string

search_criteria

Optional

The search query for the search-based alert configuration.

GenerateEventCritera

generate_alert_criteria

Optional

The basis of raising of alerts. It can take a value SEARCH_RESULT_CHANGE or ZERO_SEARCH_RESULTS

Possible values are : SEARCH_RESULT_CHANGE, ZERO_SEARCH_RESULTS,

AlertType

alert_type

Optional

The type of alert. It can take a value PROBLEM or CHANGE.

Possible values are : PROBLEM, CHANGE, INTENT,

Severity

severity

Optional

severity

Possible values are : Critical, Moderate, Warning, Info,

array of NotificationSetting

notification_settings

Optional

Notifications configured for alerts corresponding to this alert configuration.

400

Bad Request

Returns ApiError of type(s) application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}

integer As int32 As int32

code

Optional

code

string

message

Optional

message

array of ErrorDetail

details

Optional

details

401

Unauthorized

Returns ApiError of type(s) application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}

integer As int32 As int32

code

Optional

code

string

message

Optional

message

array of ErrorDetail

details

Optional

details

403

Forbidden

Returns ApiError of type(s) application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}

integer As int32 As int32

code

Optional

code

string

message

Optional

message

array of ErrorDetail

details

Optional

details

500

Internal Error

Returns ApiError of type(s) application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}

integer As int32 As int32

code

Optional

code

string

message

Optional

message

array of ErrorDetail

details

Optional

details