# 获取特定资产的趋势数据 在指定时间范围内检索包含给定时间间隔内读数的数据集。使用此数据确定规划,管理和优化工作负载的趋势。 ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. 验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 ## 步骤2:获取资产列表[​](#步骤2获取资产列表 "直接链接至步骤2:获取资产列表") 使用[获取资产](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-assets-apis/getasset.md)API请求检索您有权访问的资产。 示例 curl 请求 - 从 CH1 IBX 数据中心检索电气资产 ``` curl -X  GET "https://api.equinix.com/asset/v1/list?accountNo=1&ibx=CH1&classification=Electrical"                                                                               -H "authorization: Bearer '  ``` 示例响应 ``` {   "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"   } } ``` ## 步骤3:获取资产详情[​](#步骤3获取资产详情 "直接链接至步骤3:获取资产详情") 使用[获取资产详细信息](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-assets-apis/getassetdetails.md)API请求检索资产详细信息,包括标记点标识符。 示例 curl 请求 - 检索 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 '  ``` 示例响应 ``` {     "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"     } } ``` ## 步骤4:获取趋势数据[​](#步骤4获取趋势数据 "直接链接至步骤4:获取趋势数据") 使用[获取资产标记点趋势](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-assets-apis.md)API请求检索给定标记[点](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-assets-apis.md)的一组指定读数。 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 " ``` 示例响应 ``` {     "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"     } } ```