Show Host 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/hosts/{host_name}/history

HTTPステータスコード#

正常時：200

エラー時：400, 401, 429, 500, 503

リクエストパラメータの説明#

名前	In	Type	デフォルト値 /必須指定	Description
X-Auth-Token	header	string	必須	Domain-Scoped認証トークン
host_name	path	string	必須	物理ホスト名
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
name	string	物理ホスト名
capacities	array	キャパシティ情報(各timestamp時点)のリストオブジェクト
timestamp	string	物理ホストのキャパシティ情報の作成日時
vcpus	integer	物理ホストのvCPU数
vcpus_used	integer	割り当て済のvCPU数
vcpus_available	integer	利用可能なvCPU数
memory_gb	float	物理ホストのメモリサイズ(GiB)
memory_gb_used	float	割り当て済のメモリサイズ(GiB)
memory_gb_available	float	利用可能なメモリサイズ(GiB)

リクエスト例#

curl -H "X-Auth-Token: ImFkbWluVVJMIjogImh0dHA6Ly8xMC4x..." \
 "https://telemetry.jp-east-3.cloud.global.fujitsu.com/v1.0/capacity/hosts/sv-01-XX-XX-XX.management.jp-east-3.local/history"

レスポンス例#

{
  "name": "sv-01-XX-XX-XX.management.jp-east-3.local",
  "capacities": [
     {
        "timestamp": "2021-01-05T22:45:56",
        "vcpus": 16,
        "vcpus_used": 10,
        "vcpus_available": 6,
        "memory_gb": 48.0,
        "memory_gb_used": 31.0,
        "memory_gb_available": 16.0
     },
     ...中略
     {
        "timestamp": "2021-01-06T22:45:56",
        "vcpus": 16,
        "vcpus_used": 12,
        "vcpus_available": 4,
        "memory_gb": 48.0,
        "memory_gb_used": 31.0,
        "memory_gb_available": 16.0
     }
  ]
}