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
            }
          ]
        }
      ]
    }
  ]
}