# 功耗数据 Smart View功耗数据提供机笼和机柜中电源电路近乎实时的功耗。您可以在Smart View门户网站和API中查看IBX中所有机笼,机柜和电路的总功率和合同千伏安消耗和比率。 您需要 `View Power Draw Data` 每个IBX网点的[权限](https://docs.equinix.com/zh-Hans/iam/colocation-access-control/managing-user-permissions.md),才能访问功耗数据`Smart View`。 ## 当前功耗[​](#当前功耗 "直接链接至当前功耗") * Portal * API 登录[Smart View门户网站](https://ibxsmartview.equinix.com)。如果您已登录[客户门户网站](https://portal.equinix.com),请从全局导航菜单中选择\_Smart View\_。 要查看当前功耗数据,请从控制面板中选择IBX网点,然后单击\_功耗\_磁贴中的**详情**。 ![](https://docs.equinix.com/zh-Hans/assets/images/power-draw-tile-2b69368ba16c80fb79255bb09fa697ff.png) \_当前功耗\_图显示: * 总牵引量与合同千伏安的比率 * 总千伏安消耗 * 合同规定的千伏安(功率消耗上限) ![](https://docs.equinix.com/zh-Hans/assets/images/power-draw-current-ce7140e5873f57feb381350f5963c7b0.png) 使用下拉筛选器查看 IBX 中区域、笼子或电路的功耗。 如果您正在使用API,则必须提交身份验证令牌,有关说明,请参阅[API身份验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 要查看功耗数据,请向端点发送`GET`请求[`/power/v1/current`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/dcim-power-apis/getcurrentpowerdata.md)。在请求中指定您的账号和IBX位置信息作为查询参数。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=&ibx=&levelType=ibx&levelValue=' -H 'Authorization: Bearer ' ``` 要进一步筛选特定笼子、柜子或电路的数据,请使用其他查询参数。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=&ibx=&levelType=cabinet&levelValue=' -H 'Authorization: Bearer ' ``` > **注意** > > 如果您不知道IBX代码,机笼ID,机柜ID或电路ID,请使用[`/smartview/v1/hierarchy/power`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-hierarchy-apis/getpowerhierarchy.md)端点检索电源层次结构数据。 ### 趋势和任务[​](#趋势和任务 "直接链接至趋势和任务") * Portal * API *Trends and Tasks (趋势和任务*)选项卡显示了不同时间段的7天峰消耗上限: * 与昨天相比。 * 与上周相比。 * 与上个月相比。 * 与上季度相比。 ![](https://docs.equinix.com/zh-Hans/assets/images/power-draw-trends-tasks-9c6f9dc6c2167430179f5657f476847d.png) 使用\_当前功耗\_下拉筛选条件将数据筛选到IBX中的区域,机笼或电路。 要查看7天峰消耗上限比较数据,请向端点发送`GET`请求[`/power/v1/current`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/dcim-power-apis/getcurrentpowerdata.md)。在请求中指定您的账号和IBX位置信息作为查询参数。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=&ibx=&levelType=ibx&levelValue=' -H 'Authorization: Bearer ' ``` Responses`comparisonData`对象包含与`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=&ibx=&levelType=cabinet&levelValue=' -H 'Authorization: Bearer ' ``` ### 图形视图[​](#图形视图 "直接链接至图形视图") * Portal * API 您可以查看给定时间段内每15分钟间隔的功耗(kVA)至最大允许功率(%)。单击**图形视图**以图形格式查看数据。 ![](https://docs.equinix.com/zh-Hans/assets/images/power-draw-graphical-ce7140e5873f57feb381350f5963c7b0.png) 从图表下方的下拉过滤器中选择最多五个机笼、机柜或电路,以查看其电力使用情况的图形比较。 选择时间段,对要查看的上一天,周或月数据进行趋势分析。要自定义日期范围,请使用日历。 要查看给定时段内的功耗(kVA)至最大允许功率(%),请向端点发送`GET`请求[`/power/v1/trending`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/dcim-power-apis/gettrendingpowerdata.md)。使用查询参数指定: * 您的账号和IBX交易所所在地。 * 数据点的间隔,来自`recording`,`1h`或`1d`。 * 起始时间以毫秒为单位,以时间戳表示。 * 结束时间以毫秒为单位,用时间戳表示。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/power/v1/trending?accountNo=&ibx=&levelType=ibx&levelValue=&interval=&fromDate=&toDate=' -H 'Authorization: Bearer ' ``` 要进一步筛选特定笼子、柜子或电路的数据,请使用其他查询参数。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/power/v1/trending?accountNo=&ibx=&levelType=cabinet&levelValue=&interval=&fromDate=&toDate=' -H 'Authorization: Bearer ' ``` ## 机笼[​](#机笼 "直接链接至机笼") \_机笼\_表显示您在IBX内的机笼,机柜和电路功耗的详细信息。 ![](https://docs.equinix.com/zh-Hans/assets/images/power-draw-cages-108745ed54032241aac7d5cd52286af1.png) 展开每个机笼以查看机柜数据。将每个机柜扩展到电路级别以获取详细信息。 彩色高亮显示表示笼子、机柜或电路接近其总 kVA 与合同 kVA 比率 (%) 的上限水平。 * 资产的功耗在其用电上限10%以内时,系统会以黄色突出显示**总用电与合同kVA的百分比**值。 * 当资产的功耗超过其用电上限时,系统会以红色突出显示**总用电与合同kVA的百分比**值。 ## 生成报告[​](#生成报告 "直接链接至生成报告") 导出数据集的已配置趋势以创建报告。您可以根据用于生成趋势的数据生成PDF文档。 创建特定报告,或从页面下部查看所有**近期生成的**报告,**高级报告**和**已保存的模板**。 ![](https://docs.equinix.com/zh-Hans/assets/images/environmental-reports-3e5104252eefefbb750c79ad209a6d01.png)