Obtenez des données sur les tendances pour un actif spécifique
Récupérez des ensembles de données contenant des relevés entre un intervalle de temps donné, dans une période spécifiée. Utilisez ces données pour établir des tendances afin de planifier, gérer et optimiser vos charges de travail.
Conditions préalables
- Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.
Étape 2 : Obtenir la liste des équipements
Utilisez la demandeGet Assets API pour récupérer les actifs auxquels vous avez l’autorisation d’accéder.
Exemple de requête curl - récupérer les actifs électriques dans le centre de données CH1 IBX
curl -X
GET "https://api.equinix.com/asset/v1/list?accountNo=1&ibx=CH1&classification=Electrical"
-H "authorization: Bearer <token>'
Exemple de réponse
{
"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"
}
}
Étape 3 : Obtenir des détails sur les équipements
Utilisez la demande APIobtenir les détails de l'équipement pour récupérer les détails de l'équipement, y compris les identifiants de point de balise.
Exemple de requête curl - récupérer les détails 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>'
Exemple de réponse
{
"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"
}
}
Étape 4 : Obtenir les données de tendances
Utilisez la demandeGet Asset Tag point Trending API pour récupérer un ensemble spécifié de mesures pour le point de balise donné.
Exemple de requête 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>"
Exemple de réponse
{
"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"
}
}