Show Storage Capacity History#
プライベートリソースの物理ストレージのキャパシティ履歴情報を表示します。
📒注:このAPIを実行するためには、以下条件のどちらかを満たしている必要があります。
- ドメインに対するロールがユーザに設定されている
- ドメインに対するロールが設定されたグループにユーザが属している
APIエンドポイント#
リージョン | APIエンドポイント |
---|---|
西日本リージョン3の場合 | https://telemetry.jp-west-3.cloud.global.fujitsu.com |
東日本リージョン3の場合 | https://telemetry.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
GET
/v1.0/capacity/storages/history
HTTPステータスコード#
正常時:200
エラー時:400, 401, 429, 500, 503
リクエストパラメータの説明#
名前 | In | Type | デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
X-Auth-Token | header | string | 必須 | Domain-Scoped認証トークン |
start | query | string | 現在日時から24時間前 /任意 |
取得開始日時(UTC) 日時の入力形式は以下のISO 8601形式です。 YYYY-MM-DDThh:mm:ss startはendより過去日を指定してください。 startとendで指定できる期間は最大31日間です。 |
end | query | string | 現在日時 /任意 |
取得終了日時(UTC) 日時の入力形式は以下のISO 8601形式です。 YYYY-MM-DDThh:mm:ss endはstartより未来日を指定してください。 startとendで指定できる期間は最大31日間です。 |
レスポンスボディ(正常系)の説明#
名前 | Type | Description |
---|---|---|
storage_capacities | array | 物理ストレージ全体のキャパシティ情報(timestamp時点)のリストオブジェクト |
timestamp | string | 物理ストレージ全体のキャパシティ情報の作成日時 |
max_gb | integer | 物理ストレージの最大サイズ(GiB) |
used_gb | integer | 使用済の物理ストレージサイズ(GiB) |
available_gb | integer | 利用可能な物理ストレージサイズ(GiB) |
volume_count | integer | 利用中の物理ストレージに存在するブロックストレージ数 |
snapshot_count | integer | 利用中の物理ストレージに存在するスナップショット数 |
リクエスト例#
curl -H "X-Auth-Token: ImFkbWluVVJMIjogImh0dHA6Ly8xMC4x..." \ "https://telemetry.jp-east-3.cloud.global.fujitsu.com/v1.0/capacity/storages/history"
レスポンス例#
{ "storage_capacities": [ { "timestamp": "2021-01-05T22:45:56", "max_gb": 460800, "used_gb": 50000, "available_gb": 410800, "volume_count": 10, "snapshot_count": 3 }, ...中略 { "timestamp": "2021-01-06T22:45:56", "max_gb": 460800, "used_gb": 60000, "available_gb": 400800, "volume_count": 10, "snapshot_count": 3 } ] }