消費電力データ
Smart View消費電力データは、ケージやキャビネットの電源回路のほぼリアルタイムの電力使用量を提供します。Smart ViewポータルおよびAPIで、IBX内のすべてのケージ、キャビネット、回路の合計および契約kVAの消費電力と比率を表示できます。
電力消費量データにアクセスするには、 各IBX拠点の権限とView Power Draw Data権限が必要です。Smart View
現在の消費電力
- Portal
- API
Smart Viewポータルにサインインします。カスタマーポータルにサインインしている場合は、グローバルナビゲーションメニューから[_スマートビュー]を_選択します。
現在の消費電力データを表示するには、ダッシュボードからIBX拠点を選択し、_消費電力_タイルの詳細をクリックします。

_現在の消費電力_グラフには、以下が表示されます。
- 総引き込み対契約kVA比
- 総kVAドロー
- 契約kVA(消費電力上限)

ドロップダウンフィルターを使用して、IBXのゾーン、ケージ、または回路の消費電力を表示します。
APIを使用している場合は、認証トークンを送信する必要があります。手順については、「API認証」を参照してください。
消費電力データを表示するには、エンドポイントにリクエストを/power/v1/current送信します。GETリクエストのクエリパラメータとして、アカウント番号とIBXロケーション情報を指定します。
cURLリクエストのサンプル:
curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ibx&levelValue=<ibx_code>'
-H 'Authorization: Bearer <token>'
データを特定のケージ、キャビネット、または回線にさらに絞り込むには、追加のクエリパラメータを使用します。
cURLリクエストのサンプル:
curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=cabinet&levelValue=<cabinet_id>'
-H 'Authorization: Bearer <token>'
IBXコード、ケージID、キャビネットID、または回線IDがわからない場合は、エンドポイントを使用して/smartview/v1/hierarchy/power電力階層データを取得してください。
トレンドとタスク
- Portal
- API
_[トレンドとタスク]_タブには、異なる期間における7日間のピーク契約電力値が表示されます。
- 昨日と比べて今
- 先週との比較
- 先月との比較
- 前四半期との比較

_現在の消費電力_ドロップダウンフィルターを使用して、データをIBX内のゾーン、ケージ、または回路にフィルタリングします。
7日間のピーク契約電力値比較データを表示するには、エンドポイントにリクエストを/power/v1/current送信します。GETリクエストのクエリパラメータとして、アカウント番号とIBXロケーション情報を指定します。
cURLリクエストのサンプル:
curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ibx&levelValue=<ibx_code>'
-H 'Authorization: Bearer <token>'
responsescomparisonDataオブジェクトには、と、、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=<your_account_no>&ibx=<ibx_code>&levelType=cabinet&levelValue=<cabinet_id>' -H 'Authorization: Bearer <token>'
グラフビュー
- Portal
- API
指定された期間内の15分間隔ごとに、許容される最大電力kVA(%)を表示できます。グラフビューをクリックすると、データがグラフ形式で表示されます。

グラフの下にあるドロップダウンフィルターから、最大5つのケージ、キャビネット、または回路を選択すると、それらの電力使用量のグラフ比較が表示されます。
表示したいデータを最終日、週、または月からトレンド表示する期間を選択します。日付範囲をカスタマイズするには、カレンダーを使用します。
指定された期間に許容される最大電力(%) kVAを表示するには、エンドポイントにリクエストを/power/v1/trending送信します。GETクエリパラメータを使用して、以下を指定します。
- アカウント番号とIBXの拠点。
- データポイントの間隔、開始、
recording1hまたは。1d - ミリ秒単位のエポックタイム。
- ミリ秒単位のエポックタイム。
cURLリクエストのサンプル:
curl -X GET 'https://api.equinix.com/power/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/power/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>'
ケージ
_ケージ_テーブルには、IBX内のケージ、キャビネット、回路の消費電力の詳細が表示されます。

各ケージを展開すると、キャビネットのデータが表示されます。詳細については、各キャビネットを回路レベルまで展開してください。
色付きのハイライトは、ケージ、キャビネット、または回路が、総契約kVA比(%)のドローキャップレベルに近づいていることを示します。
- アセットの消費電力が契約電力値の10%以内になると、契約電力kVAの合計値が黄色で強調表示されます。
- アセットの消費電力が契約電力値を超えると、契約電力kVAの合計値が赤色で強調表示されます。
レポートを生成
データセットの設定されたトレンドをエクスポートしてレポートを作成します。トレンドの生成に使用したデータからPDFドキュメントを生成できます。
ページ下部のセクションから、特定のレポートを作成するか、最近生成されたレポート、詳細レポート、保存されたテンプレートをすべて表示します。
