[{"label":"Latest (2.0.1)","version":"latest"}]
telco-cloud-service-assurance
List Ack Alarms
DescriptionThis operation lists or finds AckAlarms entities
Request
URLURL
https://{api_host}tcsa.host.com/tcsa/api/tmf/v1/ackAlarms
Query Parameters
Query Parameters
string
fields
Optional
Comma-separated properties to be provided in response
fields example
"id"
integer
limit
Optional
Requested number of resources to be provided in response
limit example
10
integer
offset
Optional
Requested index for start of resources to be provided in response
offset example
0
Authentication
This operation uses the following authentication methods.
Response
integer
Response
Response BodyResponse Body
200 OK
Returns
array of
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
Response Headers
integer
X-Total-Count
Total number of items matching criteria
X-Total-Count example
1000
X-Result-Count
Actual number of items returned in the response body
X-Result-Count example
10Errors
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
[{"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
