# 消費電力データ Smart View消費電力データは、ケージやキャビネットの電源回路のほぼリアルタイムの電力使用量を提供します。Smart ViewポータルおよびAPIで、IBX内のすべてのケージ、キャビネット、回路の合計および契約kVAの消費電力と比率を表示できます。 電力消費量データにアクセスするには、 各IBX拠点の[権限](https://docs.equinix.com/ja/iam/colocation-access-control/managing-user-permissions.md)と`View Power Draw Data`[権限が](https://docs.equinix.com/ja/iam/colocation-access-control/managing-user-permissions.md)必要です。`Smart View` ## 現在の消費電力[​](#現在の消費電力 "への直接リンク現在の消費電力") * Portal * API [Smart Viewポータル](https://ibxsmartview.equinix.com)にサインインします。[カスタマーポータルに](https://portal.equinix.com)サインインしている場合は、グローバルナビゲーションメニューから[\_スマートビュー]を\_選択します。 現在の消費電力データを表示するには、ダッシュボードからIBX拠点を選択し、\_消費電力\_タイルの**詳細を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/power-draw-tile-2b69368ba16c80fb79255bb09fa697ff.png) \_現在の消費電力\_グラフには、以下が表示されます。 * 総引き込み対契約kVA比 * 総kVAドロー * 契約kVA(消費電力上限) ![](https://docs.equinix.com/ja/assets/images/power-draw-current-ce7140e5873f57feb381350f5963c7b0.png) ドロップダウンフィルターを使用して、IBXのゾーン、ケージ、または回路の消費電力を表示します。 APIを使用している場合は、認証トークンを送信する必要があります。手順については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 消費電力データを表示するには、エンドポイントにリクエストを[`/power/v1/current`](https://docs.equinix.com/ja/api-catalog/smartviewv2/dcim-power-apis/getcurrentpowerdata.md)送信します。`GET`リクエストのクエリパラメータとして、アカウント番号とIBXロケーション情報を指定します。 cURLリクエストのサンプル: ``` curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=&ibx=&levelType=ibx&levelValue=' -H 'Authorization: Bearer ' ``` データを特定のケージ、キャビネット、または回線にさらに絞り込むには、追加のクエリパラメータを使用します。 cURLリクエストのサンプル: ``` curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=&ibx=&levelType=cabinet&levelValue=' -H 'Authorization: Bearer ' ``` > **メモ** > > IBXコード、ケージID、キャビネットID、または回線IDがわからない場合は、エンドポイントを使用して[`/smartview/v1/hierarchy/power`](https://docs.equinix.com/ja/api-catalog/smartviewv2/smartview-hierarchy-apis/getpowerhierarchy.md)電力階層データを取得してください。 ### トレンドとタスク[​](#トレンドとタスク "への直接リンクトレンドとタスク") * Portal * API \_[トレンドとタスク]\_タブには、異なる期間における7日間のピーク契約電力値が表示されます。 * 昨日と比べて今 * 先週との比較 * 先月との比較 * 前四半期との比較 ![](https://docs.equinix.com/ja/assets/images/power-draw-trends-tasks-9c6f9dc6c2167430179f5657f476847d.png) \_現在の消費電力\_ドロップダウンフィルターを使用して、データをIBX内のゾーン、ケージ、または回路にフィルタリングします。 7日間のピーク契約電力値比較データを表示するには、エンドポイントにリクエストを[`/power/v1/current`](https://docs.equinix.com/ja/api-catalog/smartviewv2/dcim-power-apis/getcurrentpowerdata.md)送信します。`GET`リクエストのクエリパラメータとして、アカウント番号とIBXロケーション情報を指定します。 cURLリクエストのサンプル: ``` curl -X GET 'https://api.equinix.com/power/v1/current?accountNo=&ibx=&levelType=ibx&levelValue=' -H 'Authorization: Bearer ' ``` responses`comparisonData`オブジェクトには、と、、`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=&ibx=&levelType=cabinet&levelValue=' -H 'Authorization: Bearer ' ``` ### グラフビュー[​](#グラフビュー "への直接リンクグラフビュー") * Portal * API 指定された期間内の15分間隔ごとに、許容される最大電力kVA(%)を表示できます。**グラフビューを**クリックすると、データがグラフ形式で表示されます。 ![](https://docs.equinix.com/ja/assets/images/power-draw-graphical-ce7140e5873f57feb381350f5963c7b0.png) グラフの下にあるドロップダウンフィルターから、最大5つのケージ、キャビネット、または回路を選択すると、それらの電力使用量のグラフ比較が表示されます。 表示したいデータを最終日、週、または月からトレンド表示する期間を選択します。日付範囲をカスタマイズするには、カレンダーを使用します。 指定された期間に許容される最大電力(%) kVAを表示するには、エンドポイントにリクエストを[`/power/v1/trending`](https://docs.equinix.com/ja/api-catalog/smartviewv2/dcim-power-apis/gettrendingpowerdata.md)送信します。`GET`クエリパラメータを使用して、以下を指定します。 * アカウント番号とIBXの拠点。 * データポイントの間隔、開始、`recording` `1h`または。`1d` * ミリ秒単位のエポックタイム。 * ミリ秒単位のエポックタイム。 cURLリクエストのサンプル: ``` curl -X GET 'https://api.equinix.com/power/v1/trending?accountNo=&ibx=&levelType=ibx&levelValue=&interval=&fromDate=&toDate=' -H 'Authorization: Bearer ' ``` データを特定のケージ、キャビネット、または回線にさらに絞り込むには、追加のクエリパラメータを使用します。 cURLリクエストのサンプル: ``` curl -X GET 'https://api.equinix.com/power/v1/trending?accountNo=&ibx=&levelType=cabinet&levelValue=&interval=&fromDate=&toDate=' -H 'Authorization: Bearer ' ``` ## ケージ[​](#ケージ "への直接リンクケージ") \_ケージ\_テーブルには、IBX内のケージ、キャビネット、回路の消費電力の詳細が表示されます。 ![](https://docs.equinix.com/ja/assets/images/power-draw-cages-108745ed54032241aac7d5cd52286af1.png) 各ケージを展開すると、キャビネットのデータが表示されます。詳細については、各キャビネットを回路レベルまで展開してください。 色付きのハイライトは、ケージ、キャビネット、または回路が、総契約kVA比(%)のドローキャップレベルに近づいていることを示します。 * アセットの消費電力が**契約**電力値の10%以内になると、**契約電力kVAの合計**値が黄色で強調表示されます。 * アセットの消費電力が**契約**電力値を超えると、**契約電力kVAの合計**値が赤色で強調表示されます。 ## レポートを生成[​](#レポートを生成 "への直接リンクレポートを生成") データセットの設定されたトレンドをエクスポートしてレポートを作成します。トレンドの生成に使用したデータからPDFドキュメントを生成できます。 ページ下部のセクションから、特定のレポートを作成するか、**最近生成された**レポート、**詳細レポート**、**保存されたテンプレートを**すべて表示します。 ![](https://docs.equinix.com/ja/assets/images/environmental-reports-3e5104252eefefbb750c79ad209a6d01.png)