VM マネージャーの取得
インフラストラクチャー内で定義されている VM マネージャーに関する情報を要求するには、api/sam/vmmanagers
エレメントに対して GET
操作を使用します。この REST API では、ユーザー・インターフェースで表示される情報よりも多くの情報が返されます。これにより、集中モードと分散モードの両方で管理されている VM マネージャー、90 日間を超えて非アクティブな状態だったVM マネージャー、および削除された VM マネージャーに関する情報が返されます。また、RHV-M がない Xen や KVM など VM マネージャーに対する接続の定義が不要な仮想テクノロジーの情報も返されます。データの収集元となる VM マネージャーの範囲は、自分に割り当てられているコンピューター・グループに属するコンピューターにインストールされている VM マネージャー・ツールによって異なります。
VM マネージャーに関する情報を取得するには、「VM マネージャーとサーバーの管理」権限が必要です。
操作の詳細 | 「説明」 |
---|---|
操作 | GET /api/sam/vmmanagers |
目的 | VM マネージャーのリストを返します。 |
HTTP メソッド | GET |
リソース URI | https://server_host_name:port_number/api/sam/vmmanagers?token=token |
要求 Content-Type |
application/json |
応答 Content-Type |
application/json |
正常な HTTP 応答コード |
|
エラーの HTTP 応答コード |
メッセージの本文にはエラー・メッセージと詳細が含まれます。 |
応答属性
属性 | 指定可能な値 |
---|---|
deleted |
BigFix Inventory から VM マネージャーが削除されたかどうかを示します。 |
lastmodified |
VM マネージャーが最後に変更された日時。 |
login |
VM マネージャーにアクセスするのに使用するユーザー名。 |
protocol |
VM マネージャーで使用される通信プロトコル。この属性は、Hyper-V にのみ適用できます。
|
sharedcredentials |
VM マネージャーが、同じクラスター内の他のホストと資格情報を共有するかどうかを示します。この属性は、Hyper-V にのみ適用できます。 |
status |
VM マネージャーのステータス。
|
type |
VM マネージャーのタイプ。
|
url |
VM マネージャーの Web アドレス。 |
vmmanagerid |
VM マネージャーの ID。 |
vmmanagertoolid |
特定の VM マネージャーから情報を収集する VM Manager toolの ID。 |
HTTP 会話の例
- 要求
-
GET http://localhost:9081/api/sam/vmmanagers ?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
- 応答の本文 (JSON)
-
[{ "vmmanagerid":1, "protocol":null, "deleted":false, "vmmanagertoolid":1, "sharecredentials":false, "lastmodified":"2016-06-12 09:06:51.723", "login":"admin@internal", "type":3, "url":"https:\/\/9.156.44.146:8443\/api", "status":98 }]