Obtener datos de tendencias para un activo específico
Recupere conjuntos de datos que contengan lecturas entre un intervalo de tiempo determinado, en un marco temporal específico. Utilice estos datos para establecer tendencias que le permitan planificar, gestionar y optimizar sus cargas de trabajo.
Requisitos previos
- Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.
Paso 2: Obtener la lista de activos
Utilice la solicitud API Obtener activos para recuperar los activos a los que tiene permiso para acceder.
Ejemplo de solicitud curl - recuperar activos eléctricos en el centro de datos CH1 IBX
curl -X
GET "https://api.equinix.com/asset/v1/list?accountNo=1&ibx=CH1&classification=Electrical"
-H "authorization: Bearer <token>'
Ejemplo de respuesta
{
"payLoad": {
"classification": "Electrical",
"categories": [
{
"templates": [
{
"assets": [
{
"assetId": "CH1.Gen-1",
"ibx": "CH1",
"alarmStatus": "OK",
"resiliencyStatus": "Resiliency as Designed",
"alarmLastTriggeredTime": "Sep 16,2016 04:41 PM",
"alarmLastClearedTime": "Sep 16,2016 04:43 PM"
},
{
"assetId": "CH1.Gen-2",
"ibx": "CH1",
"alarmStatus": "OK",
"resiliencyStatus": "Resiliency as Designed",
"alarmLastTriggeredTime": "Sep 20,2016 04:48 PM",
"alarmLastClearedTime": "Sep 20,2016 04:53 PM"
},
{
"assetId": "CH1.Gen-3",
"ibx": "CH1",
"alarmStatus": "OK",
"resiliencyStatus": "Resiliency as Designed",
"alarmLastTriggeredTime": "Oct 04,2016 07:54 AM",
"alarmLastClearedTime": "Oct 04,2016 08:41 AM"
}
],
"templateId": "Generator"
}
],
"categoryName": "Global"
}
]
},
"status": {
"type": "INFO",
"statuscode": "1000",
"msg": "OK"
}
}
Paso 3: Obtener información sobre los activos
Utilice la solicitud API Obtener detalles de activos para recuperar los detalles de los activos, incluidos los identificadores de puntos de etiqueta.
Ejemplo de petición curl - recuperar detalles de CH1.Gen-1
curl -X
GET "https://api.equinix.com/asset/v1/details?accountNo=1&ibx=CH1&assetId=CH1.Gen-1&classification=Electrical"
-H "authorization: Bearer <token>'
Ejemplo de respuesta
{
"payLoad": {
"assetId": "CH1.Gen-1",
"assetType": "Generator",
"userPrefTimeZone": "America/Los_Angeles",
"tags": [
{
"value": "78.5",
"tagId": "CH1.Gen-1:fuelhours",
"tagDisplayName": "Fuel Hours",
"uom": "h",
"alarmStatus": "OK",
"readingTime": "20190324023353"
},
{
"value": "0",
"tagId": "CH1.Gen-1:runningemergencyservice",
"tagDisplayName": "Running Emergency Service",
"uom": "",
"alarmStatus": "OK",
"readingTime": "20190324023421"
},
{
"value": "0.0",
"tagId": "CH1.Gen-1:voltage",
"tagDisplayName": "Voltage",
"uom": "V",
"alarmStatus": "OK",
"readingTime": "20190324022309"
},
{
"value": "NORMAL",
"tagId": "CH1.Gen-1:alarm",
"tagDisplayName": "Alarm",
"uom": "",
"alarmStatus": "OK",
"readingTime": "20190324022351"
},
{
"value": "0",
"tagId": "CH1.Gen-1:runningnonemergencyservice",
"tagDisplayName": "Running NonEmergency Service",
"uom": "",
"alarmStatus": "OK",
"readingTime": "20190324023421"
},
{
"value": "READY TO START, AUTO",
"tagId": "CH1.Gen-1:summary",
"tagDisplayName": "Summary",
"uom": "",
"alarmStatus": "OK",
"readingTime": "20190324023421"
}
],
"lastMaintenanceDate": "Mar 17,2019",
"manufacturerName": "CATERPILLAR",
"equipmentModelNumber": "SR-4B",
"equipmentSerialNumber": "5JW00638",
"alarmLastTriggeredTime": null,
"alarmLastProcessedTime": null
},
"status": {
"type": "INFO",
"statuscode": "1000",
"msg": "OK"
}
}
Paso 4: Obtener datos de tendencias
Utilice la solicitud API Obtener tendencias de puntos de etiqueta de activos para recuperar un conjunto especificado de lecturas para el punto de etiqueta dado.
Ejemplo de solicitud curl
curl -X
GET "https://api.equinix.com/asset/v1/tagpoint/trending?accountNo=1&ibx=CH1&tagId=CH1.Gen-5:fuelhours&interval=1h&fromDate=1483244949000&toDate=1493958549001"
-H "authorization: Bearer <token>"
Ejemplo de respuesta
{
"payLoad": {
"accountNumber": "1",
"ibx": "CH1",
"interval": "1h",
"uom": "h",
"tagId": "CH1.Gen-5:fuelhours",
"tagDisplayName": "Fuel Hours",
"dataType": "Float",
"data": [
{
"datetime": "1484355108000",
"value": "81.21"
},
{
"datetime": "1484365910000",
"value": "80.35"
},
{
"datetime": "1484373126000",
"value": "81.23"
},
{
"datetime": "1484383929000",
"value": "82.15"
},
{
"datetime": "1484405555000",
"value": "81.33"
}
]
},
"status": {
"type": "INFO",
"statuscode": "1000",
"msg": "OK"
}
}