[{"label":"Latest (2.0.1)","version":"latest"}]
telco-cloud-service-assurance
Retrieve Ack Alarms
DescriptionThis operation retrieves an AckAlarms entity. Attribute selection is enabled for all first level attributes.
Request
URLURL
https://{api_host}tcsa.host.com/tcsa/api/tmf/v1/ackAlarms/{id}
Path Parameters
Path Parameters
string
id
Required
Identifier of the AckAlarms
id example
"QD36DoQBIPNwSiXT4onj"
Query Parameters
Query Parameters
string
fields
Optional
Comma-separated properties to provide in response
fields example
"id"
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK
Returns
AckAlarms
of type application/json
{
"@baseType": null,
"@schemaLocation": null,
"@type": null,
"ackSystemId": "admin",
"ackTime": "2022-10-25T11:50:33.944752Z",
"ackUserId": "admin",
"ackedAlarm": [
{
"@baseType": "alarm",
"@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
"@type": "notification",
"ackState": "UNACKNOWLEDGED",
"ackSystemId": null,
"ackUserId": null,
"affectedService": null,
"alarmChangedTime": "2022-10-25T11:47:57Z",
"alarmClearedTime": null,
"alarmDetails": "Indicates that a failed card is the root cause.",
"alarmEscalation": null,
"alarmRaisedTime": "2022-10-25T11:48:18.056Z",
"alarmReportingTime": "2022-10-25T11:48:18.056Z",
"alarmType": "Down",
"alarmedObject": {
"@baseType": "alarm",
"@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
"@type": "notification",
"href": "/tcsa/api/topology/v1/instances/BEM-10.31.161.51%5Blimal051%5D%2F1%24BladeEnclosureManager%24INCHARGE-SA-PRES",
"id": "BEM-10.31.161.51[limal051]/1$BladeEnclosureManager$INCHARGE-SA-PRES"
},
"alarmedObjectType": "Card",
"clearSystemId": null,
"clearUserId": null,
"comment": [
{
"baseType": "alarm",
"comment": "Server: INCHARGE-SA",
"schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
"systemId": "null",
"time": "2022-10-25T11:47:14Z",
"type": "notification",
"userId": "DXA"
}
],
"correlatedAlarm": [
{
"@baseType": "alarm",
"@referredType": null,
"@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
"@type": "notification",
"href": "/tcsa/api/alarms/Name%3ANOTIFICATION-BladeEnclosureManager_BEM-10.31.161.51%5Blimal051%5D%2F1_Unresponsive%24Source%3AINCHARGE-SA-PRES%24",
"id": "Name:NOTIFICATION-BladeEnclosureManager_BEM-10.31.161.51[limal051]/1_Unresponsive$Source:INCHARGE-SA-PRES$",
"name": "Name:NOTIFICATION-BladeEnclosureManager_BEM-10.31.161.51[limal051]/1_Unresponsive$Source:INCHARGE-SA-PRES$"
},
{
"@baseType": "alarm",
"@referredType": null,
"@schemaLocation": "https://developer.vmware.com/apis/telco-cloud-service-assurance/latest",
"@type": "notification",
"href": "/tcsa/api/alarms/Name%3ANOTIFICATION-Blade_BLD-BEM-10.31.161.51%5Blimal051%5D%2F1%2Fsys%2Fchassis-1%2Fblade-7_Unresponsive%24Source%3AINCHARGE-SA-PRES%24",
"id": "Name:NOTIFICATION-Blade_BLD-BEM-10.31.161.51[limal051]/1/sys/chassis-1/blade-7_Unresponsive$Source:INCHARGE-SA-PRES$",
"name": "Name:NOTIFICATION-Blade_BLD-BEM-10.31.161.51[limal051]/1/sys/chassis-1/blade-7_Unresponsive$Source:INCHARGE-SA-PRES$"
}
],
"crossedThresholdInformation": {},
"externalAlarmId": null,
"href": "/tcsa/api/tmf/v1/alarms/Name%3ANOTIFICATION-Card_CARD-10.31.161.51%5Blimal051%5D%2F39896_Down%24Source%3AINCHARGE-SA-PRES%24",
"id": "Name:NOTIFICATION-Card_CARD-10.31.161.51[limal051]/39896_Down$Source:INCHARGE-SA-PRES$",
"instanceName": null,
"isRootCause": true,
"parentAlarm": [],
"perceivedSeverity": "CRITICAL",
"place": [],
"plannedOutageIndicator": "OUT_OF_SERVICE",
"probableCause": null,
"proposedRepairedActions": null,
"reportingSystemId": null,
"rootCause": true,
"serviceAffecting": null,
"source": null,
"sourceSystemId": "INCHARGE-AM",
"specificProblem": null,
"state": "ACTIVE"
}
],
"alarmPattern": [
{
"id": "Name:NOTIFICATION-Card_CARD-10.31.161.51[limal051]/39896_Down$Source:INCHARGE-SA-PRES$"
},
{
"id": "Name:NOTIFICATION-Blade_BLD-BEM-10.31.161.51[limal051]/1/sys/chassis-1/blade-7_Down$Source:INCHARGE-SA-PRES$"
},
{
"id": "Name:NOTIFICATION-CPU__Performance__HostResources_I-CPU__Performance__HostResources-PSR-10.107.118.170/14_HighUtilization$Source:INCHARGE-SA-PRES$"
}
],
"href": "/tcsa/api/tmf/v1/ackAlarms/QD36DoQBIPNwSiXT4onj",
"id": "QD36DoQBIPNwSiXT4onj",
"state": "COMPLETED"
}
string
@baseType
Optional
When sub-classing, this defines the super-class
string 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
string
ackSystemId
Optional
Name of the acknowledging system
string as date-time
ackTime
Optional
Time of the acknowledgement
string
ackUserId
Optional
Name of the acknowledging user
array of
Alarm
alarmPattern
Optional
Alarm patterns to match target alarms. An alarm will match if an attribute in any of the patterns is equal to the corresponding attribute of the alarm. The attributes which are supported with matching are - id, alarmType, alarmedObjectType, perceivedSeverity, plannedOutageIndicator and state.
string
href
Optional
A reference to the task
string
id
Optional
The identifier of the task
string
state
Optional
Current state of the operation task
Errors
Error
400
Bad Request
Error
401
Unauthorized
Error
403
Forbidden
Error
404
Not Found
Error
405
Method Not allowed
Error
409
Conflict
Error
500
Internal Server Error
Code Samples
cURL Command
curl https://{api_host}tcsa.host.com/tcsa/api/tmf/v1/ackAlarms/QD36DoQBIPNwSiXT4onj
[{"label":"Latest (2.0.1)","version":"latest"}]
telco-cloud-service-assurance
On This Page
Tmf Alarms Operations
post
post
post
post
delete
get
get
patch
get
