功耗数据
Smart View功率消耗数据提供了机架和机柜中的电路近乎实时的功率使用情况。您可以在Smart View门户和API中查看IBX中所有保持架，机柜和电路的总kVA和收缩kVA绘制和比率。
为了访问您的功耗数据，您需要Smart View View Power Draw Data 每个IBX位置的权限。
当前功耗
- Portal
- API
登录Smart View门户。如果您已登录客户门户，请从全局导航菜单中选择_Smart View_。
要查看当前功耗数据，请从仪表板中选择IBX位置，然后单击_功耗_磁贴中的详细信息。
_当前功耗_图表显示：
- 总牵引量与合同千伏安的比率
- 总千伏安消耗
- 合同规定的千伏安（功率消耗上限）
使用下拉筛选器查看 IBX 中区域、笼子或电路的功耗。
如果您使用的是API，则必须提交身份验证令牌，有关说明，请参见API身份验证。
要查看功耗数据，请向端点发送GET请求/power/v1/current。在请求中指定您的帐号和IBX位置信息作为查询参数。
cURL 请求示例：
curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ibx&levelValue=<ibx_code>'
-H 'Authorization: Bearer <token>'
要进一步筛选特定笼子、柜子或电路的数据，请使用其他查询参数。
cURL 请求示例：
curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=cabinet&levelValue=<cabinet_id>'
-H 'Authorization: Bearer <token>'
如果您不知道IBX代码，机架ID，机柜ID或电路ID，请使用/smartview/v1/hierarchy/power端点检索电源层次数据。
趋势和任务
- Portal
- API
Trends and Tasks (趋势和任务)选项卡显示不同时间段的7天峰值上限：
- 与昨天相比。
- 与上周相比。
- 与上个月相比。
- 与上季度相比。
使用_"当前功率消耗"_下拉筛选器将数据筛选到IBX中的区段，笼或电路。
要查看7天的峰值绘制上限比较数据，请向端点发送GET请求/power/v1/current。在请求中指定您的帐号和IBX位置信息作为查询参数。
cURL 请求示例：
curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ibx&levelValue=<ibx_code>'
-H 'Authorization: Bearer <token>'
ResponsescomparisonData对象包含与yesterday，lastWeek，lastMonth和之间的峰值百分比kVA比较percentageKva``lastQuarter。
示例回答（已截断）：
...
"percentageKva": 341.54,
"comparisonData": {
"datapoint": "percentageKva",
"yesterday": 0.147,
"lastWeek": -0.295,
"lastMonth": -0.184,
"lastQuarter": 52.434
},
...
要进一步筛选特定笼子、柜子或电路的比较数据，请使用其他查询参数。
cURL 请求示例：
curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=cabinet&levelValue=<cabinet_id>' -H 'Authorization: Bearer <token>'
图形视图
- Portal
- API
您可以查看给定时间段内每15分钟间隔的功率消耗kVA至最大允许值(%)。单击图形视图以图形格式查看数据。
从图表下方的下拉过滤器中选择最多五个机笼、机柜或电路，以查看其电力使用情况的图形比较。
选择一个时间段，对要查看的最后一天，一周或一个月的数据进行趋势分析。要自定义日期范围，请使用日历。
要查看给定时间段内最大允许功率(%)的功耗kVA，请向端点发送GET请求/power/v1/trending。使用查询参数指定：
- 您的账号和IBX交易所所在地。
- 数据点的间隔，从
recording，1h或1d。 - 起始时间以毫秒为单位，以时间戳表示。
- 结束时间以毫秒为单位，用时间戳表示。
cURL 请求示例：
curl -X GET 'https://api.equinix.com/power/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ibx&levelValue=<ibx_code>&interval=<interval>&fromDate=<epoch_timestamp_milliseconds>&toDate=<epoch_timestamp_milliseconds>'
-H 'Authorization: Bearer <token>'
要进一步筛选特定笼子、柜子或电路的数据，请使用其他查询参数。
cURL 请求示例：
curl -X GET 'https://api.equinix.com/power/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=cabinet&levelValue=<cabinet_id>&interval=<interval>&fromDate=<epoch_timestamp_milliseconds>&toDate=<epoch_timestamp_milliseconds>'
-H 'Authorization: Bearer <token>'
机笼
_笼_表显示IBX中笼，机柜和电路的功耗的详细信息。
展开每个固定框架以查看机箱数据。将每个机柜扩展到电路级别以获取详细信息。
彩色高亮显示表示笼子、机柜或电路接近其总 kVA 与合同 kVA 比率 (%) 的上限水平。
- 当资产的功耗在其功耗上限的10%以内时，系统会以黄色突出显示**总功耗与合同kVA %**值。
- 当资产的功耗超过其功耗上限时，系统会以红色突出显示**总耗电到合同的kVA %**值。
生成报告
导出已配置的数据集趋势以创建报告。您可以使用用于生成趋势的数据生成PDF文档。
从页面的下半部分创建特定报告或查看所有最近生成的报告，高级报告和保存的模板。
