功耗数据
Smart View功耗数据提供机笼和机柜中电源电路近乎实时的功耗。您可以在Smart View门户网站和API中查看IBX中所有机笼,机柜和电路的总功率和合同千伏安消耗和比率。
您需要 View Power Draw Data 每个IBX网点的权限,才能访问功耗数据Smart View。
当前功耗
- 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文档。
创建特定报告,或从页面下部查看所有近期生成的报告,高级报告和已保存的模板。
