环境数据

"环境数据"部分显示整个IBX以及保持架所在冷却区的近乎实时的温度和湿度条件。您可以使用此部分监视这些情况。

提示

冷却区是数据中心内由公共机械基础设施支撑的区域。

提示

要指定温度是以华氏还是摄氏度显示，请参阅用户首选项。

温度和湿度数据

Portal

如果您的组织购买了环境传感器，您可以在此页面上查看柜体和笼子级别的温度和湿度数据。

要查看此信息，请从仪表板上IBX的环境磁贴中选择所有区域或特定区域。

本页显示：

• IBX 外部的当前温度和湿度

• IBX内部所有冷却区域的平均温度和湿度

• 冷却区内所有环境传感器的平均温度和湿度

  我们使用中值读数, 因为冷却区的传感器安装在不同位置, 以监控和管理冷却设备的运行, 以及现场设备产生的热负荷。这些位置包括热空气回流，冷空气分配，靠近天花板的区域和笼中的区域。

• 不同时间段的环境状况趋势，例如现在与昨天相比、现在与上周相比以及现在与上个月相比。

• 创建自定义提醒的选项

• 能够查看、自定义和导出环境数据趋势

API

如果您使用的是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，CAGE或SENSOR，并提供匹配项levelValue。

cURL 请求示例：

curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=CAGE&levelValue=<cage_id>'
-H 'Authorization: Bearer <token>'

注意

如果您不知道IBX代码，区域或固定架ID，请使用/smartview/v1/hierarchy/location端点检索位置层次结构数据。

冷却区数据

Portal

要查看特定冷却区域内的温度和湿度，请从 IBX 的下拉列表中选择该区域。

注意

只有安装了环境传感器的笼子/柜子才能获得这些环境读数。

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=ZONE&levelValue=<zone_id>'
-H 'Authorization: Bearer <token>'

响应返回指定位置的当前环境读数，包括温度、湿度和读数时间戳等值。

示例回答（已截断）：

{
  "temperature": 72.5,
  "humidity": 45.2,
  "timestamp": "2024-05-01T14:30:00Z"
}

要将数据进一步过滤到特定的固定框架中，请将固定框架ID与一起使用levelType=CAGE``levelValue。

cURL 请求示例：

curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=CAGE&levelValue=<cage_id>'
-H 'Authorization: Bearer <token>'

数据趋势

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|CAGE|SENSOR>&levelValue=<level_value>&interval=<interval>&fromDate=<ISO8601_datetime>&toDate=<ISO8601_datetime>'
-H 'Authorization: Bearer <token>'

生成报告

导出已配置的数据集趋势以创建报告。您可以使用用于生成趋势的数据生成PDF文档。

从页面的下半部分创建特定报告或查看所有最近生成的报告，高级报告和保存的模板。