環境データ
環境データセクションには、IBX 全体およびケージのある冷却ゾーンの温度と湿度がほぼリアルタイムで表示されます。このセクションを使用して、これらの条件を監視できます。
冷却ゾーンは、共通の機械インフラストラクチャでサポートされているデータセンターのエリアです。
温度を華氏で表示するか摂氏で表示するかを指定するには、ユーザー設定 を参照してください。
温湿度データ
- Portal
- API
あなたの組織が環境センサーを購入した場合、このページでキャビネットとケージレベルの温度と湿度のデータを見ることができます。
この情報を表示するには、ダッシュボードのIBXのEnvironmental(環境)タイルから、All Zones 、または特定のゾーンを選択します。

このページで紹介しています。
-
現在のIBXの外気温と湿度
-
IBX内の全冷房ゾーンの平均温度・湿度
-
冷却ゾーン内の全環境センサーの温度・湿度の中央値
中央値を使用するのは、冷却ゾーンのセンサーが、冷却プラントの運転と現場の機器から発生する熱負荷を監視・管理するために、さまざまな場所に設置されているからです。このような場所には、温風リターン、冷風分配、天井付近、ケージ内などが含まれます。
-
昨日と今、先週と今、先月と今など、異なる時間帯での環境状態の推移。
-
カスタムアラートを作成するオプション
-
環境データの傾向を表示、カスタマイズ、エクスポートする機能

APIを使用する場合は、認証トークンを送信する必要があります。手順については、API認証を参照してください。
温湿度データを表示するには、/environment/v1/current エンドポイントに GET リクエストを送信します。リクエストのクエリパラメータとして、アカウント番号と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
- API
特定の冷却ゾーン内の温度と湿度を表示するには、IBXのドロップダウンリストから選択します。

これらの環境測定値は、環境センサーが設置されているケージ/キャビネットでのみ利用可能です。
冷却ゾーンデータを表示するには、/environment/v1/current エンドポイントに GET リクエストを送信します。リクエストのクエリパラメータとして、アカウント番号と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 を levelValue として levelType=CAGE を使用します。
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
トレンドとタスクのデータをグラフ形式で表示するには、グラフビュー に切り替えます。

グラフ下のドロップダウン・フィルターから冷却ゾーンまたはキャビネットを最大5つまで選択し、それらの環境条件をグラフで比較できます。システムは両方のグラフ間で選択を同期します。
タイムフレームを選択して、表示したいデータを直近の1日、1週間、1ヶ月から傾向付けします。日付範囲をカスタマイズするには、カレンダーを使用します。
7 日間の比較データを表示するには、/environmental/v1/current エンドポイントに GET リクエストを送信します。リクエストのクエリーパラメーターとして、アカウント番号とIBXのロケーション情報を指定してください。
cURLリクエストのサンプル:
curl -X GET 'https://api.equinix.com/environment/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/environment/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>'
レポートの作成
設定されたデータセットのトレンドをエクスポートしてレポートを作成します。トレンド生成に使用したデータから PDF ドキュメントを生成できます。
特定のレポートを作成したり、ページの下部から最近作成したレポート 、高度なレポート 、保存したテンプレート をすべて表示したりできます。

生成されたレポートの詳細については、レポート を参照してください。