消費電力データ
Smart View Power Draw データは、ケージやキャビネット内の電源回路の電力使用量をほぼリアルタイムで提供します。Smart ViewポータルとAPIで、IBX内のすべてのケージ、キャビネット、回路の合計および契約kVAドローと比率を表示できます。
Power Drawのデータにアクセスするには、IBXの各拠点で「Smart View」と「View Power Draw Data」のpermissionsが必要です。
現在の消費電力
- Portal
- API
Equinix Smart Viewポータルにサインインします。エクイニクスカスタマーポータルにサインインしている場合は、グローバルナビゲーションメニューから_Smart View_を選択します。
現在の消費電力データを表示するには、ダッシュボードからIBXロケーションを選択し、_Power Draw_タイルのDetails 。
現在の消費電力のグラフは、次のとおりです：
- 総引き込み対契約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
Trends and Tasks_] タブには、さまざまな期間における 7 日間のピーク電力上限が表示されます：
- 昨日と比べて今
- 先週との比較
- 先月との比較
- 前四半期との比較
IBXのゾーン、ケージ、または回路にデータをフィルタするには、_Current Power Draw_ドロップダウン・フィルタを使用します。
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>'
レスポンスの comparisonData オブジェクトには、percentageKva と yesterday、lastWeek、lastMonth、lastQuarter とのピークパーセント kVA 比較が格納されています。
回答例（切り捨て）：
...
"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つのケージ、キャビネット、または回路を選択すると、それらの電力使用量のグラフ比較が表示されます。
タイムフレームを選択して、表示したいデータを直近の1日、1週間、1ヶ月から傾向付けします。日付範囲をカスタマイズするには、カレンダーを使用します。
指定された期間における許容最大電力（%）に対する電力引き込み kVA を表示するには、/power/v1/trending エンドポイントに GET リクエストを送信します。クエリパラメータを使用して指定します：
- お客様のアカウント番号とIBXの所在地です。
- データポイントの間隔、
recording、1h、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>'
ケージ
Cages_の表には、IBX内のケージ、キャビネット、および回路の消費電力の詳細が表示されます。
各ケージを展開するとキャビネットのデータが表示されます。各キャビネットを回路レベルまで展開すると、詳細情報が表示されます。
色付きのハイライトは、ケージ、キャビネット、または回路が、総契約kVA比（%）のドローキャップレベルに近づいていることを示します。
- 資産の電力引き込み量が引き込みキャップの10%以内である場合、システムはTotal Draw-to-Contracted kVA % の値を黄色で強調表示します。
- 資産の電力引き込み量が引き込み上限を超えると、システムはTotal Draw-to-Contracted kVA % の値を赤色で強調表示します。
レポートの作成
設定されたデータセットのトレンドをエクスポートしてレポートを作成します。トレンド生成に使用したデータから PDF ドキュメントを生成できます。
特定のレポートを作成したり、ページの下部から最近作成したレポート 、高度なレポート 、保存したテンプレート をすべて表示したりできます。
生成されたレポートの詳細については、レポート を参照してください。