Get Caused By | Telco Cloud Service Assurance

Get Caused By

Returns the list of notification, that are causing the requested notification.

Request

URI

POST

https://{api_host}/tcsa.host.com/tcsa/api/notification-management/v1/notifications/caused-by

COPY

Request Body

Request body contains parameters to get list of notification that are caused by requested notification.

RootCausedByRequest of type(s) application/json

Required

Show optional properties

{
    "deDupKey": "Name:NOTIFICATION-NetworkFunction_NetworkFunction-ebf940d1-9166-4e3b-bb17-c6b8d200bdc2_Impaired$Source:INCHARGE-SA-PRES$"
}

{
    "deDupKey": "Name:NOTIFICATION-NetworkFunction_NetworkFunction-ebf940d1-9166-4e3b-bb17-c6b8d200bdc2_Impaired$Source:INCHARGE-SA-PRES$",
    "size": 10,
    "from": 0,
    "sort": [
        {
            "order": "desc",
            "fieldName": "Severity"
        }
    ],
    "vsafilter": {
        "condition": "AND",
        "filterlist": [
            "Filter Object"
        ]
    },
    "isLive": false
}

string

deDupKey

Required

DeDupkey uniquely indentifies the notification across domains.

integer As int32 As int32

size

Optional

The size parameter allows you to configure the maximum amount of notifications to be returned.

integer As int32 As int32

from

Optional

The from parameter defines the offset from the first result user want to fetch.

array of Sort

sort

Optional

The Sort object defines, on which field sorting has to be apply and what will be the sorting order (ASC/DESC).

VsaFilter

vsafilter

Optional

The VSAFilter object defines how the filters has to be applied on queries.

boolean

isLive

Optional

Setting value to "true" returns the root caused-by for live notification, setting value to "false "will return root caused-by for historical notification. Default is "true"

Authentication

This operation uses the following authentication methods.

bearerAuth

Responses

200

Returns CausedByResponse of type(s) application/json

{
    "Count": 1,
    "Result": [
        {
            "UserDefined8": "",
            "TroubleTicketID": "",
            "UserDefined9": "",
            "UserDefined6": "",
            "Owner": "",
            "UserDefined7": "",
            "InMaintenance": false,
            "SourceInfo": "INCHARGE-SA",
            "IsProblem": true,
            "EventType": "DURABLE",
            "IsLiveNotification": true,
            "ProcessedTimeStamp": 1662382231244,
            "UserDefined1": "",
            "InstanceDisplayName": "kube-metaswitch-np1-76ddcc547d-5pp6k",
            "UserDefined4": "",
            "UserDefined5": "",
            "UserDefined2": "",
            "ElementClassName": "KubernetesWorker",
            "Name": "NOTIFICATION-KubernetesWorker_KubernetesWorker-96105fd2-1a74-46b6-ac8f-e869609e8d42_Down",
            "UserDefined3": "",
            "PollingID": 1662381989790,
            "EventText": "Indicates that root cause is failed system.",
            "ElementName": "KubernetesWorker-96105fd2-1a74-46b6-ac8f-e869609e8d42",
            "LastChangedAt": 1661231881000,
            "elementUUID": "KubernetesWorker-96105fd2-1a74-46b6-ac8f-e869609e8d42$KubernetesWorker$INCHARGE-SA-PRES",
            "Impact": 0,
            "deviceType": "KubernetesWorker",
            "UserDefined19": "",
            "UserDefined18": "",
            "UserDefined17": "",
            "UserDefined16": "",
            "HasCauses": true,
            "UserDefined15": "",
            "UserDefined14": "",
            "UserDefined13": "",
            "OriginalSources": [],
            "NotificationStates": [
                {
                    "syncTimestamp": 1662382231244,
                    "source": "INCHARGE-SA-PRES",
                    "eventState": "ACTIVE",
                    "eventTimestamp": 1661231881000,
                    "syncId": 1662381989790
                }
            ],
            "tags": {
                "location": "",
                "customer": ""
            },
            "InstanceName": "KubernetesWorker-96105fd2-1a74-46b6-ac8f-e869609e8d42",
            "DeDupKey": "Name:NOTIFICATION-KubernetesWorker_KubernetesWorker-96105fd2-1a74-46b6-ac8f-e869609e8d42_Down$Source:INCHARGE-SA-PRES$",
            "Active": true,
            "LastNotifiedAt": 1660934327000,
            "SourceDomainName": "INCHARGE-ESM",
            "UserDefined20": "",
            "Acknowledged": false,
            "IsRoot": true,
            "Category": "Availability",
            "EventDisplayName": "Down",
            "Certainty": 100,
            "elementUUID_PM": "KubernetesWorker-96105fd2-1a74-46b6-ac8f-e869609e8d42$KubernetesWorker$",
            "Source": "INCHARGE-SA-PRES",
            "UserDefined12": "",
            "ClassName": "KubernetesWorker",
            "DisplayName": "KubernetesWorker Down 100.0%: kube-metaswitch-np1-76ddcc547d-5pp6k",
            "instanceUUID": "KubernetesWorker-96105fd2-1a74-46b6-ac8f-e869609e8d42$KubernetesWorker$INCHARGE-SA-PRES",
            "UserDefined11": "",
            "UserDefined10": "https://10.62.72.35/ui/index.action#/inventory/all/96105fd2-1a74-46b6-ac8f-e869609e8d42/summary",
            "FirstNotifiedAt": 1660934327000,
            "EventState": "ACTIVE",
            "Severity": 1,
            "EventName": "Down",
            "SourceSpecific": "primary",
            "ClassDisplayName": "KubernetesWorker",
            "OccurrenceCount": 2,
            "PollingState": "POLLING",
            "ClearOnAcknowledge": false,
            "SourceEventType": "PROBLEM"
        }
    ]
}

integer

Count

Optional

total number of notification

array of Notification

Result

Optional

An array of notfication objects.

401

Client must authenticate itself to get the requested response

Operation doesn't return any data structure

403