功率消耗数据
Smart View 功率消耗数据可提供您机柜和机笼中电源回路的近实时功率使用情况。您可以通过 Smart View 门户和 API 查看 IBX 中所有机柜、机笼和回路的总 kVA 消耗量和合同 kVA 消耗量及比率。
要访问您的 Power Draw 数据，您需要为每个 IBX 位置授予 Smart View 和 View Power Draw Data 权限。
当前功率消耗
- Portal
- API
登录Smart View门户。如果您已登录客户门户，请从全局导航菜单中选择_Smart View_。
要查看当前的功耗数据，请从您的仪表板中选择一个 IBX 位置，然后单击“功耗”图块中的“详细信息”。
当前功耗图表显示：
- 总牵引量与合同千伏安的比率
- 总的千伏安电流
- 合同规定的千伏安（功率消耗上限）
使用下拉筛选器查看 IBX 中区域、笼子或电路的功耗。
如果您正在使用 API，则必须提交身份验证令牌，请参阅 API 身份验证 以获取说明。
要查看功耗数据，请向 /power/v1/current 端点发送 GET 请求。在请求中，请将您的账号和 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
“趋势和任务”选项卡显示了不同时间段内 7 天峰值提款上限：
- 与昨天相比。
- 与上周相比。
- 与上个月相比。
- 与上季度相比。
使用“当前功耗”下拉筛选器，将数据筛选到 IBX 中的区域、笼子或电路。
要查看 7 天峰值用电量上限对比数据，请向 /power/v1/current 端点发送 GET 请求。请在请求中将您的账号和 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>'
响应的 comparisonData 对象包含 percentageKva 与 yesterday、lastWeek、lastMonth 和 lastQuarter 之间的峰值百分比 kVA 比较。
示例回答（已截断）：
...
"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 分钟间隔的功率消耗（千伏安）与最大允许功率的百分比（%）。点击“图表视图”以图形格式查看数据。
从图表下方的下拉过滤器中最多选择5个机笼、机柜或电路，以查看其电力使用情况的图表比较。
选择一个时间范围，从最近一天、一周或一个月的数据中选择你要查看的趋势。要定制日期范围，请使用日历。
要查看给定时间段内功率消耗 kVA 占最大允许功率的百分比 (%)，请向 /power/v1/trending 端点发送 GET 请求。使用查询参数指定：
- 您的账号和IBX交易所所在地。
- 数据点的间隔，从“记录”、“1 小时”或“1 天”。
- 起始时间以毫秒为单位，以时间戳表示。
- 结束时间以毫秒为单位，用时间戳表示。
示例 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>'
笼子
Cages 表显示 IBX 中机柜、机柜和电路的功耗详情。
展开每个笼子，查看机柜数据。将每个机柜扩展到电路层面，以获得详细信息。
彩色高亮显示表示笼子、机柜或电路接近其总 kVA 与合同 kVA 比率 (%) 的上限水平。
- 当资产的功率消耗在其消耗上限的 10% 以内时，系统会以黄色突出显示 总消耗量与合同 kVA 百分比 值。
- 当资产的功率消耗超过其消耗上限时，系统会以红色突出显示总消耗量与合同 kVA 百分比值。
生成报告
导出数据集的配置趋势来创建一个报告。你可以从用于生成趋势的数据中生成一个PDF文件。
在页面下方，您可以创建特定报告或查看所有最近生成的报告、高级报告和已保存的模板。
有关所有生成报告的详细信息，请参阅报告。