Skip to main content

Effective 10 September 2024, API Documentation can be found on our Equinix Product Documentation site.
The content on this page will not be updated after 1 Oct 2024 and will be inaccessible after 31st Dec 2024.


Get Active System Alerts

SmartView GetAlarms

Step 1: Authenticate

Submit your Client ID and Client Secret to obtain authorization token.

curl -X
POST 'https://api.equinix.com/oauth2/v1/token'
-H 'content-type: application/json'
-d '{
"grant_type": "client_credentials",
"client_id": "ABCDE12345",
"client_secret": "shhDontTell"
}'
 

Refer to Generating Client ID and Client Secret under Getting Access Token section for instructions on how to create client ID and client secret.
Refer to Requesting Access and Refresh tokens for more information on how to authorize your API calls.

 

If you are unaware of your user credentials for Equinix Smart View, contact your local Equinix Service Desk.

Step 2: Retrieve Active System Alerts

Use the Retrieve System Alerts API request to retrieve system alerts that match provided search criteria.

Sample curl request - retrieve active system alerts

curl -X POST 'http://api.equinix.com/smartview/v2/systemAlerts/search'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
"filter": {
"and": [
{
"property": "/status",
"operator": "=",
"values": [
"ACTIVE"
]
}
]
},
"pagination": {
"offset": 0,
"limit": 50
}
}'
 

For additional filtering options, see Retrieve System Alerts.

Sample response

{
"data": [
{
"id": 1931,
"alertUid": "LD9.Generator-DH09-PG2:gensetavailableinauto#DIGITAL:ALARM",
"traceUid": "1687495706640/LD9.Generator-DH09-PG2:gensetavailableinauto#DIGITAL:ALARM",
"assetTagUid": "LD9.Generator-DH09-PG2:gensetavailableinauto",
"assetTagDisplayName": "Genset Available In Auto",
"status": "ACTIVE",
"value": {
"alertTagValue": "true",
"alertTagValueDisplayName": "OPEN",
"activeAlertTagValueDisplayName": "OPEN",
"currentTagValue": "CLOSED"
},
"asset": {
"ibx": "LD9",
"assetUid": "LD9.Generator-DH09-PG2",
"assetType": "Generator",
"assetClassification": "Electrical",
"assetRegion": null,
"assetUnderMaintenance": false
},
"configuration": {
"thresholdValue": "1",
"thresholdValueDisplayName": "OPEN",
"unitOfMeasurement": "&",
"thresholdType": "DIGITAL",
"conditionName": "ALARM",
"configurationVersion": "1.0"
},
"activeProcessing": {
"edgeCollectedOn": "2023-06-23T04:48:26.640Z",
"tagCalculationJobProcessedOn": "2023-06-23T04:48:26.840Z",
"processingStartOn": "2023-06-23T04:49:01.182223Z",
"processingEndOn": "2023-06-23T04:49:01.282301Z",
"publishedOn": "2023-06-23T04:49:01.282301Z"
},
"inactiveProcessing": {
"edgeCollectedOn": null,
"tagCalculationJobProcessedOn": null,
"processingStartOn": null,
"processingEndOn": null,
"publishedOn": null
}
},
{
"id": 9684,
"alertUid": "LD4.UPS-4-2-G-15:lowbatteryalarm#DIGITAL:ALARM",
"traceUid": "1687474008537/LD4.UPS-4-2-G-15:lowbatteryalarm#DIGITAL:ALARM",
"assetTagUid": "LD4.UPS-4-2-G-15:lowbatteryalarm",
"assetTagDisplayName": "Low Battery Alarm",
"status": "ACTIVE",
"value": {
"alertTagValue": "true",
"alertTagValueDisplayName": "OPEN",
"activeAlertTagValueDisplayName": "OPEN",
"currentTagValue": "OPEN"
},
"asset": {
"ibx": "LD4",
"assetUid": "LD4.UPS-4-2-G-15",
"assetType": "UPS",
"assetClassification": "Electrical",
"assetRegion": null,
"assetUnderMaintenance": false
},
"configuration": {
"thresholdValue": "1",
"thresholdValueDisplayName": "OPEN",
"unitOfMeasurement": "&",
"thresholdType": "DIGITAL",
"conditionName": "ALARM",
"configurationVersion": "1.0"
},
"activeProcessing": {
"edgeCollectedOn": "2023-06-22T22:46:48.537Z",
"tagCalculationJobProcessedOn": "2023-06-22T22:46:48.737Z",
"processingStartOn": "2023-06-22T22:47:37.722099Z",
"processingEndOn": "2023-06-22T22:47:37.802681Z",
"publishedOn": "2023-06-22T22:47:37.802681Z"
},
"inactiveProcessing": {
"edgeCollectedOn": null,
"tagCalculationJobProcessedOn": null,
"processingStartOn": null,
"processingEndOn": null,
"publishedOn": null
}
}
],
"pagination": {
"offset": 20,
"limit": 10,
"total": 2
}
}