Show Host Capacity#

プライベートリソースの物理ホストごとのキャパシティ情報を表示します。

📒注:この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

HTTPステータスコード#

正常時：200

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

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

名前	In	Type	デフォルト値 /必須指定	Description
X-Auth-Token	header	string	必須	Domain-Scoped認証トークン

レスポンスボディ（正常系）の説明#

名前	Type	Description
host_capacities	array	物理ホストごとのキャパシティ情報のリストオブジェクト
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)
deployable_flavors	array	配備可能なフレーバー情報のオブジェクト 📘ヒント: 契約している物理ホストのタイプ（スタンダードCPU、ハイスピードCPU）によっては、実際に配備できないフレーバーも含まれます。
flavor_id	string	フレーバーのUUID
flavor_name	string	フレーバー名
deployable_count	integer	配備可能なフレーバー数フレーバサイズ（仮想CPU、メモリ）と物理ホストの空き容量から算出した値です。

リクエスト例#

curl -H "X-Auth-Token: ImFkbWluVVJMIjogImh0dHA6Ly8xMC4x..." \
 "https://telemetry.jp-west-3.cloud.global.fujitsu.com/v1.0/capacity/hosts"

レスポンス例#

{
  "host_capacities": [
    {
      "name": "sv-01-XX-XX-XX.management.jp-west-3.local",
      "capacities": [
        {
          "timestamp": "2021-01-05T23:45:56",
          "vcpus": 16,
          "vcpus_used": 10,
          "vcpus_available": 6,
          "memory_gb": 48.0,
          "memory_gb_used": 31.0,
          "memory_gb_available": 16.0,
          "deployable_flavors": [
            {
              "id": "6bb56f4f-be9d-42e6-b63e-49476629e07c",
              "name": "P3-1.d",
              "deployable_count": 3
            },

              ・・・（中略）

            {
              "id": "oi0eilpp-42e6-b63e-07ce-29e6629e09b",
              "name": "P12-1.d",
              "deployable_count": 6
            }
          ]
        }
      ]
    }
  ]
}