Create Intent

Create Intent

Intent Creation

Request
URI
POST
https://vrni.example.com/api/ni/alert-configs/intents/
COPY
Request Body

Add a new Intent Configuration; Available values for highlighted field names: alertType: [ Intent, SdwanIntent ] enabled : [ true , false ] severity : [ Warning, Critical, Moderate, Info ] intentTypeId : [ MtuMismatch, HsrpStpColocation, PortModeMismatch, NativeVlanMismatch, TrunkPortVlanMismatch, DuplexMismatch, PortChannelMismatch, DuplicateMacAddress, DuplicateIPAddress, StpMetricInconsistency ]

Some of these intent types support additional paramters. Available parameters values for those intent types are as follows:

intentTypeId paramValues.id ValueType Values
DuplexMismatch CheckMgmtInterface BOOLEAN true , false
SkipWhenNoInfo BOOLEAN true , false
SkipAutoDuplex BOOLEAN true , false
HsrpConfiguration SkipDownInterfaces BOOLEAN true , false
CheckActiveStandby BOOLEAN true , false
CheckSingleActive BOOLEAN true , false
MtuMismatch CheckMgmtInterface BOOLEAN true , false
SkipWhenNoInfo BOOLEAN true , false
DuplicateMacAddress --
DuplicateIPAddress --
HsrpStpColocation --
NativeVlanMismatch --
NativeVlanTagMismatch --
PortChannelMismatch --
PortModeMismatch --
StpMetricInconsistency --
TrunkPortVlanMismatch --
AlertConfigIntentObject of type(s) application/json
Required
{
    "name": "mtuCheck",
    "alertType": "Intent",
    "intentTypeId": "MtuMismatch",
    "filterRules": {
        "isValid": "string",
        "filterType": "string",
        "rules": [
            {
                "membership": {
                    "membershipType": "string",
                    "objectType": "integer",
                    "entities": [
                        {
                            "modelKey": "string",
                            "name": "string"
                        }
                    ],
                    "query": "string"
                }
            }
        ]
    },
    "paramValues": [
        {
            "id": "min-violation-duration",
            "values": "VIOLATION_DURATION_FIVE_MINUTES",
            "valueType": "FIXED_MULTI_CHOICE_SINGLE_VALUE"
        }
    ],
    "selected_scope": "All Applications",
    "description": "Monitor traffic rate and total bandwidth for applications",
    "enabled": true,
    "severity": "Info",
    "notes": "Mtu check",
    "tags": [
        [
            "Device Health",
            "MTU",
            "dummy"
        ]
    ],
    "notificationSettings": [
        {
            "type": "string",
            "frequency": "string",
            "enabled": true,
            "receivers": [
                [
                    "[email protected]"
                ]
            ],
            "schedule": [
                {
                    "type": "string",
                    "periodInMS": "integer",
                    "startTimestamp": "integer"
                }
            ]
        }
    ]
}
string
name
Optional

Intent name

string
alertType
Optional

Intent type

string
intentTypeId
Optional

Intent type

object
filterRules
Optional

filterRules

paramValues
Optional

Intent parameters

string
selected_scope
Optional

Intent scope

string
description
Optional

Intent description

boolean
enabled
Optional

enabled

string
severity
Optional

Intent severity

string
notes
Optional

Intent notes

array of string
tags
Optional

Intent tags

notificationSettings
Optional

notificationSettings

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Operation doesn't return any data structure

400

Bad Request

Returns ApiError of type(s) application/json
{
    "code": "integer",
    "message": "string",
    "details": [
        {
            "code": "integer",
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


401

Un-authorized

Returns ApiError of type(s) application/json
{
    "code": "integer",
    "message": "string",
    "details": [
        {
            "code": "integer",
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


409

Name conflicts with already existing intent

Returns ApiError of type(s) application/json
{
    "code": "integer",
    "message": "string",
    "details": [
        {
            "code": "integer",
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


500

Internal Error

Operation doesn't return any data structure