环境数据
环境数据部分显示整个IBX以及您的机笼所在的冷却区的近乎实时的温度和湿度条件。您可以使用此部分监控这些情况。
冷却区是数据中心内由公共机械基础设施支撑的区域。
要指定温度以华氏还是摄氏显示,请参阅用户偏好设置。
温度和湿度数据
- Portal
- API
要查看此信息,请从控制面板上IBX的“环境”磁贴中选择“所有区域”或“特定区域”。

本页显示:
-
IBX 外部的当前温度和湿度
-
IBX内部所有冷却区域的平均温度和湿度
-
冷却区内所有环境传感器的平均温度和湿度
我们使用中值读数是因为冷却区的传感器安装在不同位置, 以监控和管理冷却设备的运行, 以及现场设备产生的热量负荷。这些位置包括热空气回流区,冷空气分布区,天花板附近区域和机笼中的区域。
-
不同时间段的环境状况趋势,例如现在与昨天相比、现在与上周相比以及现在与上个月相比。
-
创建自定义提醒的选项
-
能够查看、自定义和导出环境数据趋势

如果您正在使用API,则必须提交身份验证令牌,有关说明,请参阅API身份验证。
要查看温度和湿度数据,请向端点发送GET请求/environment/v1/current。在请求中指定您的账号和IBX位置信息作为查询参数。
cURL 请求示例:
curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=IBX&levelValue=<ibx_code>'
-H 'Authorization: Bearer <token>'
要进一步筛选您的数据,请将与支持的值之一配合使用levelType:IBX或ZONE,并提供匹配levelValue项。
cURL 请求示例:
curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ZONE&levelValue=<zone_id>'
-H 'Authorization: Bearer <token>'
如果您不知道IBX代码,区域或机笼ID,请使用/smartview/v1/hierarchy/location端点检索位置层次结构数据。
冷却区数据
- Portal
- API
要查看特定冷却区域内的温度和湿度,请从 IBX 的下拉列表中选择该区域。

要查看冷却区数据,请向端点发送GET请求/environment/v1/current。在请求中指定您的账号和IBX位置信息作为查询参数。
cURL 请求示例:
curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ZONE&levelValue=<zone_id>'
-H 'Authorization: Bearer <token>'
响应返回指定位置的当前环境读数,包括温度、湿度和读数时间戳等值。
示例回答(已截断):
{
"temperature": 72.5,
"humidity": 45.2,
"timestamp": "2024-05-01T14:30:00Z"
}
数据趋势
- Portal
- API
切换到图形视图,以图形格式查看“趋势和任务”中的数据。

从图形下方的下拉筛选条件中选择最多五个冷却区或机柜,以查看其环境条件的图形比较。系统会同步两个图形之间的选择。
选择时间段,对要查看的上一天,周或月数据进行趋势分析。要自定义日期范围,请使用日历。
要查看趋势环境数据,请向端点发送GET请求/environment/v1/trending。指定您的账号,IBX网点,数据点,级别类型,级别值,将间隔和日期范围作为请求中的查询参数。
cURL 请求示例:
curl -X GET 'https://api.equinix.com/environment/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&dataPoint=<temperature|humidity>&levelType=<IBX|ZONE>&levelValue=<level_value>&interval=<interval>&fromDate=<ISO8601_datetime>&toDate=<ISO8601_datetime>'
-H 'Authorization: Bearer <token>'
生成报告
导出数据集的已配置趋势以创建报告。您可以根据用于生成趋势的数据生成PDF文档。
创建特定报告,或从页面下部查看所有近期生成的报告,高级报告和已保存的模板。
