# 环境数据 环境数据部分显示整个IBX以及您的机笼所在的冷却区的近乎实时的温度和湿度条件。您可以使用此部分监控这些情况。 > **提示** > > 冷却区是数据中心内由公共机械基础设施支撑的区域。 > **提示** > > 要指定温度以华氏还是摄氏显示,请参阅[用户偏好设置](https://docs.equinix.com/zh-Hans/smart-view/smartview-dashboard.md#user-preferences)。 ## 温度和湿度数据[​](#温度和湿度数据 "直接链接至温度和湿度数据") * Portal * API 要查看此信息,请从控制面板上IBX的“环境”磁贴中选择“**所有区域**”或“特定区域”。 ![](https://docs.equinix.com/zh-Hans/assets/images/environmental-data-card-9be1a54c1464e1830a32651021d393e3.png) 本页显示: * IBX 外部的当前温度和湿度 * IBX内部所有冷却区域的平均温度和湿度 * 冷却区内所有环境传感器的平均温度和湿度 我们使用中值读数是因为冷却区的传感器安装在不同位置, 以监控和管理冷却设备的运行, 以及现场设备产生的热量负荷。这些位置包括热空气回流区,冷空气分布区,天花板附近区域和机笼中的区域。 * 不同时间段的环境状况趋势,例如现在与昨天相比、现在与上周相比以及现在与上个月相比。 * 创建自定义提醒的选项 * 能够查看、自定义和导出环境数据趋势 ![](https://docs.equinix.com/zh-Hans/assets/images/environmental-details-462b24dd3072adc6f6a8867cc39a854c.png) 如果您正在使用API,则必须提交身份验证令牌,有关说明,请参阅[API身份验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 要查看温度和湿度数据,请向端点发送`GET`请求[`/environment/v1/current`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-environment-apis/getcurrentenvironmentdata.md)。在请求中指定您的账号和IBX位置信息作为查询参数。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=&ibx=&levelType=IBX&levelValue=' -H 'Authorization: Bearer ' ``` 要进一步筛选您的数据,请将与支持的值之一配合使用`levelType`:`IBX`或`ZONE`,并提供匹配`levelValue`项。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=&ibx=&levelType=ZONE&levelValue=' -H 'Authorization: Bearer ' ``` > **注意** > > 如果您不知道IBX代码,区域或机笼ID,请使用[`/smartview/v1/hierarchy/location`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-hierarchy-apis/getlocationhierarchy.md)端点检索位置层次结构数据。 ### 冷却区数据[​](#冷却区数据 "直接链接至冷却区数据") * Portal * API 要查看特定冷却区域内的温度和湿度,请从 IBX 的下拉列表中选择该区域。 ![](https://docs.equinix.com/zh-Hans/assets/images/environmental-cooling-zones-c22f1aaf059fd811fcc30ec610521928.png) 要查看冷却区数据,请向端点发送`GET`请求[`/environment/v1/current`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-environment-apis/getcurrentenvironmentdata.md)。在请求中指定您的账号和IBX位置信息作为查询参数。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=&ibx=&levelType=ZONE&levelValue=' -H 'Authorization: Bearer ' ``` 响应返回指定位置的当前环境读数,包括温度、湿度和读数时间戳等值。 示例回答(已截断): ``` { "temperature": 72.5, "humidity": 45.2, "timestamp": "2024-05-01T14:30:00Z" } ``` ### 数据趋势[​](#数据趋势 "直接链接至数据趋势") * Portal * API 切换到**图形视图**,以图形格式查看“趋势和任务”中的数据。 ![](https://docs.equinix.com/zh-Hans/assets/images/environmental-graph-fc76edc78f9058d94a933f77d387cf8a.png) 从图形下方的下拉筛选条件中选择最多五个冷却区或机柜,以查看其环境条件的图形比较。系统会同步两个图形之间的选择。 选择时间段,对要查看的上一天,周或月数据进行趋势分析。要自定义日期范围,请使用日历。 要查看趋势环境数据,请向端点发送`GET`请求[`/environment/v1/trending`](https://docs.equinix.com/zh-Hans/api-catalog/smartviewv2/smartview-environment-apis/gettrendingenvironmentdata.md)。指定您的账号,IBX网点,数据点,级别类型,级别值,将间隔和日期范围作为请求中的查询参数。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/environment/v1/trending?accountNo=&ibx=&dataPoint=&levelType=&levelValue=&interval=&fromDate=&toDate=' -H 'Authorization: Bearer ' ``` ### 生成报告[​](#生成报告 "直接链接至生成报告") 导出数据集的已配置趋势以创建报告。您可以根据用于生成趋势的数据生成PDF文档。 创建特定报告,或从页面下部查看所有**近期生成的**报告,**高级报告**和**已保存的模板**。 ![](https://docs.equinix.com/zh-Hans/assets/images/environmental-reports-3e5104252eefefbb750c79ad209a6d01.png)