notification-rule

notification-rule
notification-rule

Model that represents a notification rule.
VMware Cloud Foundation Operations has a rule engine that evaluates these rules against generated alerts.
Actions such as sending Email, HTTP callback is done based on matching rules.
NOTE: resourceFilter and resourceKindFilter fields are deprecated, instead please use resourceFilters and resourceKindFilters fields respectively.

JSON Example
{
    "actionStatuses": [
        "string"
    ],
    "alertControlStates": [
        "string"
    ],
    "alertDefinitionIdFilters": {
        "values": [
            "string"
        ]
    },
    "alertImpactFilters": {
        "values": [
            "string"
        ]
    },
    "alertStatuses": [
        "string"
    ],
    "alertTypeFilters": [
        {
            "alertSubTypes": [
                0
            ],
            "alertType": 0
        }
    ],
    "collectorGroupId": "string",
    "collectorUUId": "string",
    "criticalities": [
        "string"
    ],
    "enabled": false,
    "id": "string",
    "links": [
        {
            "description": "string",
            "href": "string",
            "name": "string",
            "rel": "string"
        }
    ],
    "name": "string",
    "pluginId": "string",
    "properties": [
        {
            "name": "string",
            "value": "string"
        }
    ],
    "resourceFilter": {
        "childrenResourceKindFilters": [
            "string"
        ],
        "childrenResourceKindKeyFilters": [
            {
                "adapterKind": "string",
                "resourceKind": "string"
            }
        ],
        "matchResourceIdOnly": false,
        "relationship": "string",
        "resourceId": "string"
    },
    "resourceFilters": [
        {
            "childrenResourceKindFilters": [
                "string"
            ],
            "childrenResourceKindKeyFilters": [
                {
                    "adapterKind": "string",
                    "resourceKind": "string"
                }
            ],
            "matchResourceIdOnly": false,
            "relationship": "string",
            "resourceId": "string"
        }
    ],
    "resourceKindFilter": {
        "adapterKind": "string",
        "resourceKind": "string"
    },
    "resourceKindFilters": [
        {
            "adapterKind": "string",
            "resourceKind": "string"
        }
    ],
    "ruleType": "string",
    "sendHeartbeat": false,
    "templateId": "string"
}
array of string
actionStatuses
Optional

Set of Action statuses that the action is expected to be in

Possible values are : SUCCEEDED, FAILED, TIMEOUT, UNKNOWN,
array of string
alertControlStates
Optional

Set of Alert control states that the alert is expected to be in

Possible values are : OPEN, ASSIGNED, SUSPENDED, SUPPRESSED,
str-values
alertDefinitionIdFilters
Optional

alertDefinitionIdFilters

str-values
alertImpactFilters
Optional

alertImpactFilters

array of string
alertStatuses
Optional

Set of Alert states that the alert is expected to be in

Possible values are : NEW, ACTIVE, UPDATED, CANCELED,
array of AlertTypeFilter
alertTypeFilters
Optional

Filter for the rule to match Alerts which are of the specified Alert type & Alert Subtypes

string
collectorGroupId
Optional

Filter for the rule to match Alerts triggered on resources belonging to given collector group

string
collectorUUId
Optional

Filter for the rule to match Alerts triggered on resources belonging to given collector

array of string
criticalities
Optional

Set of Alert criticalities that the alert is expected to be in

Possible values are : UNKNOWN, NONE, INFORMATION, WARNING, IMMEDIATE, CRITICAL, AUTO,
boolean
enabled
Optional
Constraints: default: true

Identifier that shows if the notification rule is enabled. Enabled by default

string As uuid As uuid
id
Optional

Identifier of this rule, automatically assigned by the system on create

array of link
links
Optional

links

string
name
Required

Name of this rule

string
pluginId
Required

Identifier of the plugin for which this rule applies

array of name-value
properties
Optional

Properties associated with the given rule. This may include information such as the email addresses of
receivers/etc...

ResourceFilter
resourceFilter
Optional

Filter for resources. If matchResourceIdOnly is specified, alerts are selected if their resource ids
match with the 'resourceId' specified in the filter. Otherwise, the system looks at all the resource's children.
The possible set of children can be further filtered based on the childrenResourceKindKeyFilters.

array of ResourceFilter
resourceFilters
Optional

Filters for the rule to be matched based on the "Resource and its Children" for which the Alerts were generated. This collection takes precedence over resourceFilter field.

ResourceKindFilter
resourceKindFilter
Optional

Filter based on the resource kind

array of resource-kind-key
resourceKindFilters
Optional

Filter for the rule to be matched based on the Resource Kind for which the alert was generated

string
ruleType
Optional

Notification Rule Type

Possible values are : ALERT, ACTION, UNKNOWN,
boolean
sendHeartbeat
Optional

Filter for the rule to send Alerts while they are active. Defaulted to False if nothing is provided.

string
templateId
Optional

Identifier of the template.
NOTE: For deprecated plugin types this field will be ignored. For all other plugin types, default templates will be used if this value is not specified.

Property Of
Parameter To
Returned By