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