Retrieve Alarm | Telco Cloud Service Assurance

Retrieve Alarm

This operation retrieves an Alarm entity. Attribute selection is enabled for all first level attributes.

Request

URI

GET

https://{api_host}/tcsa.host.com/tcsa/api/tmf/v1/alarms/{id}

COPY

Path Parameters

string

Required

Identifier of the Alarm

id example

Name:NOTIFICATION-gNodeB_gNodeB-service-mavenir_DUFunctionAffected$Source:INCHARGE-SA-PRES$

Query Parameters

string

fields

Optional

Comma-separated properties to provide in response

fields example

id

Authentication

This operation uses the following authentication methods.

bearerAuth

Responses

200

Success

Returns Alarm of type(s) application/json

{
    "correlatedAlarm": [],
    "ackSystemId": null,
    "ackUserId": null,
    "affectedService": null,
    "alarmEscalation": null,
    "clearSystemId": null,
    "clearUserId": null,
    "crossedThresholdInformation": {},
    "externalAlarmId": null,
    "probableCause": null,
    "reportingSystemId": null,
    "serviceAffecting": null,
    "specificProblem": null,
    "proposedRepairedActions": null,
    "place": [],
    "id": "Name:NOTIFICATION-gNodeB_gNodeB-service-mavenir_DUFunctionAffected$Source:INCHARGE-SA-PRES$",
    "href": "/tcsa/api/tmf/v1/alarms/Name%3ANOTIFICATION-gNodeB_gNodeB-service-mavenir_DUFunctionAffected%24Source%3AINCHARGE-SA-PRES%24",
    "ackState": "UNACKNOWLEDGED",
    "alarmChangedTime": "2022-08-02T12:53:41Z",
    "alarmClearedTime": null,
    "alarmDetails": "Indicates that all of the system's IPv4 and IPv6 addresses not responding and the SNMPAgent is not responding as well. ",
    "alarmRaisedTime": "2020-08-27T08:03:03Z",
    "alarmReportingTime": "2022-10-25T08:09:12.161Z",
    "alarmType": "Unresponsive",
    "alarmedObjectType": "Router",
    "isRootCause": false,
    "perceivedSeverity": "UNKNOWN",
    "plannedOutageIndicator": "OUT_OF_SERVICE",
    "sourceSystemId": "AMPMNEWUS23000",
    "state": "ACTIVE",
    "alarmedObject": {
        "id": "AMPMNEWUS23000_PS_Router_267$Router$INCHARGE-SA-PRES2",
        "href": "/tcsa/api/topology/v1/instances/AMPMNEWUS23000_PS_Router_267%24Router%24INCHARGE-SA-PRES2",
        "@baseType": "alarm",
        "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
        "@type": "notification"
    },
    "comment": [
        {
            "systemId": null,
            "comment": "Server: INCHARGE-SA-AGG2",
            "time": "2022-08-02T12:53:30Z",
            "userId": "DXA",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification"
        },
        {
            "systemId": null,
            "comment": "Server: INCHARGE-SA-AGG2",
            "time": "2022-08-02T12:47:14Z",
            "userId": "DXA",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification"
        },
        {
            "systemId": null,
            "comment": "INCHARGE-SA-AGG2: ICS initialization",
            "time": "2022-08-02T12:45:56Z",
            "userId": "SYSTEM",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification"
        },
        {
            "systemId": null,
            "comment": "Server: INCHARGE-SA-AGG2",
            "time": "2022-01-31T13:22:13Z",
            "userId": "DXA",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification"
        },
        {
            "systemId": null,
            "comment": "Server: INCHARGE-SA-AGG2",
            "time": "2022-01-31T13:16:48Z",
            "userId": "DXA",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification"
        },
        {
            "systemId": null,
            "comment": "INCHARGE-SA-AGG2: ICS initialization",
            "time": "2022-01-31T13:14:32Z",
            "userId": "SYSTEM",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification"
        },
        {
            "systemId": null,
            "comment": "Server: INCHARGE-SA-AGG2",
            "time": "2021-03-02T09:11:06Z",
            "userId": "DXA",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification"
        }
    ],
    "parentAlarm": [
        {
            "id": "Name:NOTIFICATION-Router_AMPMNEWUS23000__PS__Router__2_Down$Source:INCHARGE-SA-PRES2$",
            "href": "/tcsa/api/alarms/Name%3ANOTIFICATION-Router_AMPMNEWUS23000__PS__Router__2_Down%24Source%3AINCHARGE-SA-PRES2%24",
            "name": "Name:NOTIFICATION-Router_AMPMNEWUS23000__PS__Router__2_Down$Source:INCHARGE-SA-PRES2$",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification",
            "@referredType": "null"
        },
        {
            "id": "Name:NOTIFICATION-Router_AMPMNEWUS23000__PS__Router__267_Down$Source:INCHARGE-SA-PRES2$",
            "href": "/tcsa/api/alarms/Name%3ANOTIFICATION-Router_AMPMNEWUS23000__PS__Router__267_Down%24Source%3AINCHARGE-SA-PRES2%24",
            "name": "Name:NOTIFICATION-Router_AMPMNEWUS23000__PS__Router__267_Down$Source:INCHARGE-SA-PRES2$",
            "@baseType": "alarm",
            "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
            "@type": "notification",
            "@referredType": "null"
        }
    ],
    "@baseType": "alarm",
    "@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
    "@type": "notification"
}

string

Optional

Identifier of the alarm, determined by the alarm owning system

string

href

Optional

A reference to the alarm.

string

ackState

Optional

Provides the Acknowledgement State of the alarm

string

ackSystemId

Optional

Provides the name of the system that last changed the ackState of an alarm, i.e. acknowledged or unacknowledged the alarm.

string

ackUserId

Optional

Provides the id of the user who has last changed the ack state of the alarm, i.e. acknowledged or unacknowledged the alarm.

string As date-time As date-time

alarmChangedTime

Optional

Indicates the last date and time when the alarm is changed on the alarm-owning system. Any change to the alarm whether coming from the alarmed resource, or triggered by a change from the client is changing this time.

string As date-time As date-time

alarmClearedTime

Optional

Indicates the time (as a date + time) at which the alarm is cleared at the source.

string

alarmDetails

Optional

Contains further information on the alarm.

boolean

alarmEscalation

Optional

Indicates if this alarm has been escalated or not.

string As date-time As date-time

alarmRaisedTime

Optional

Indicates the time (as a date + time) at which the alarm occurred at its source.

string As date-time As date-time

alarmReportingTime

Optional

Indicates the time (as a date + time) at which the alarm was reported by the owning OSS. It might be different from the alarmRaisedTime. For instance, if the alarm list is maintained by an EMS, the alarmRaisedtime would be the time the alarm was detected by the NE, while the alarmReportingTime would be the time this alarm was stored in the alarm list of the EMS.

string

alarmType

Optional

Categorize the alarm.

string

alarmedObjectType

Optional

The type (class) of the managed object associated with the event.

string

clearSystemId

Optional

Provides the id of the system where the user who invoked the alarmCleared operation is located.

string

clearUserId

Optional

Provides the id of the user who invoked the alarmCleared operation

string

externalAlarmId

Optional

An identifier of the alarm in the source system.

boolean

isRootCause

Optional

Indicates whether the alarm is a root cause alarm..

string

perceivedSeverity

Optional

Lists the possible severities that can be allocated to an Alarm.

Possible values are : CRITICAL, MAJOR, MINOR, NORMAL, UNKNOWN,

string

plannedOutageIndicator

Optional

Indicates that the Managed Object (related to this alarm) is in planned outage (in planned maintenance, or out-of-service).

Possible values are : PLANNED_MAINTENANCE, OUT_OF_SERVICE,

string

probableCause

Optional

Provides the probable cause of the alarm.

string

proposedRepairedActions

Optional

Indicates proposed repair actions, if known to the system emitting the alarm.

string

reportingSystemId

Optional

Reporting system identity.

boolean

serviceAffecting

Optional

Indicates whether the alarm affects service or not.

string

sourceSystemId

Optional

Source system identity.

string

specificProblem

Optional

Provides more specific information about the alarm.

string

state

Optional

Defines the alarm state during its life cycle

array of AffectedService

affectedService

Optional

Identifies the service affected by the alarm.

AlarmedObject

alarmedObject

Optional

Identifies the managed object instance associated with the alarm.

array of Comment

comment

Optional

comment

array of AlarmRef

correlatedAlarm

Optional

Indicates other alarms related to this alarm.

CrossedThresholdInformation

crossedThresholdInformation

Optional

Identifies the details of the threshold that has been crossed.

array of AlarmRef

parentAlarm

Optional

Indicates the parent alarms of the alarm.

array of RelatedPlaceRefOrValue

place

Optional

place

string

@baseType

Optional

The base type of this alarm.

string

@schemaLocation

Optional

A reference to the schema describing this alarm.

string

@type

Optional

The type for this alarm.

400

Bad Request

Returns Error of type(s) application/json

{
    "code": "string",
    "reason": "string",
    "message": "string",
    "status": "string",
    "referenceError": "string",
    "@baseType": "string",
    "@schemaLocation": "string",
    "@type": "string"
}

string

code

Required

Application relevant detail, defined in the API or a common list.

string

reason

Required

Explanation of the reason for the error which can be shown to a client user.

string

message

Optional

More details and corrective actions related to the error which can be shown to a client user.

string

status

Optional

HTTP Error code extension

string As uri As uri

referenceError

Optional

URI of documentation describing the error.

string

@baseType

Optional

When sub-classing, this defines the super-class.

string As uri As uri

@schemaLocation

Optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type

Optional

When sub-classing, this defines the sub-class entity name.

401

Unauthorized

Returns Error of type(s) application/json

{
    "code": "string",
    "reason": "string",
    "message": "string",
    "status": "string",
    "referenceError": "string",
    "@baseType": "string",
    "@schemaLocation": "string",
    "@type": "string"
}

string

code

Required

Application relevant detail, defined in the API or a common list.

string

reason

Required

Explanation of the reason for the error which can be shown to a client user.

string

message

Optional

More details and corrective actions related to the error which can be shown to a client user.

string

status

Optional

HTTP Error code extension

string As uri As uri

referenceError

Optional

URI of documentation describing the error.

string

@baseType

Optional

When sub-classing, this defines the super-class.

string As uri As uri

@schemaLocation

Optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type

Optional

When sub-classing, this defines the sub-class entity name.

403

Forbidden

Returns Error of type(s) application/json

{
    "code": "string",
    "reason": "string",
    "message": "string",
    "status": "string",
    "referenceError": "string",
    "@baseType": "string",
    "@schemaLocation": "string",
    "@type": "string"
}

string

code

Required

Application relevant detail, defined in the API or a common list.

string

reason

Required

Explanation of the reason for the error which can be shown to a client user.

string

message

Optional

More details and corrective actions related to the error which can be shown to a client user.

string

status

Optional

HTTP Error code extension

string As uri As uri

referenceError

Optional

URI of documentation describing the error.

string

@baseType

Optional

When sub-classing, this defines the super-class.

string As uri As uri

@schemaLocation

Optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type

Optional

When sub-classing, this defines the sub-class entity name.

404

Not Found

Returns Error of type(s) application/json

{
    "code": "string",
    "reason": "string",
    "message": "string",
    "status": "string",
    "referenceError": "string",
    "@baseType": "string",
    "@schemaLocation": "string",
    "@type": "string"
}

string

code

Required

Application relevant detail, defined in the API or a common list.

string

reason

Required

Explanation of the reason for the error which can be shown to a client user.

string

message

Optional

More details and corrective actions related to the error which can be shown to a client user.

string

status

Optional

HTTP Error code extension

string As uri As uri

referenceError

Optional

URI of documentation describing the error.

string

@baseType

Optional

When sub-classing, this defines the super-class.

string As uri As uri

@schemaLocation

Optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type

Optional

When sub-classing, this defines the sub-class entity name.

405

Method Not allowed

Returns Error of type(s) application/json

{
    "code": "string",
    "reason": "string",
    "message": "string",
    "status": "string",
    "referenceError": "string",
    "@baseType": "string",
    "@schemaLocation": "string",
    "@type": "string"
}

string

code

Required

Application relevant detail, defined in the API or a common list.

string

reason

Required

Explanation of the reason for the error which can be shown to a client user.

string

message

Optional

More details and corrective actions related to the error which can be shown to a client user.

string

status

Optional

HTTP Error code extension

string As uri As uri

referenceError

Optional

URI of documentation describing the error.

string

@baseType

Optional

When sub-classing, this defines the super-class.

string As uri As uri

@schemaLocation

Optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type

Optional

When sub-classing, this defines the sub-class entity name.

409

Conflict

Returns Error of type(s) application/json

{
    "code": "string",
    "reason": "string",
    "message": "string",
    "status": "string",
    "referenceError": "string",
    "@baseType": "string",
    "@schemaLocation": "string",
    "@type": "string"
}

string

code

Required

Application relevant detail, defined in the API or a common list.

string

reason

Required

Explanation of the reason for the error which can be shown to a client user.

string

message

Optional

More details and corrective actions related to the error which can be shown to a client user.

string

status

Optional

HTTP Error code extension

string As uri As uri

referenceError

Optional

URI of documentation describing the error.

string

@baseType

Optional

When sub-classing, this defines the super-class.

string As uri As uri

@schemaLocation

Optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type

Optional

When sub-classing, this defines the sub-class entity name.

500

Internal Server Error

Returns Error of type(s) application/json

{
    "code": "string",
    "reason": "string",
    "message": "string",
    "status": "string",
    "referenceError": "string",
    "@baseType": "string",
    "@schemaLocation": "string",
    "@type": "string"
}

string

code

Required

Application relevant detail, defined in the API or a common list.

string

reason

Required

Explanation of the reason for the error which can be shown to a client user.

string

message

Optional

More details and corrective actions related to the error which can be shown to a client user.