VM マネージャーの追加または更新
VM マネージャーの追加または更新を行うには、api/sam/vmmanagers
エレメントに対して PUT
操作を使用します。これらのアクションは、集中モードで管理されている VM マネージャーに対してのみ実行することができます。
VM マネージャーの追加または更新を行うには、以下の要件が満たされている必要があります。
- 「VM マネージャーとサーバーの管理」権限が付与されている必要があります。
- 割り当てられているコンピューター・グループに、中央 VM Manager toolがインストールされているコンピューターが含まれている必要があります。
操作の詳細 | 「説明」 |
---|---|
操作 | PUT api/sam/vmmanagers |
目的 | 新しい VM マネージャーを追加するか、既存の VM マネージャーを変更します。 |
HTTP メソッド | PUT |
リソース URI | https://server_host_name:port_number/api/sam/vmmanagers?token=token |
要求 Content-Type |
application/json |
応答 Content-Type |
application/json |
正常な HTTP 応答コード |
|
エラーの HTTP 応答コード |
|
注: 円記号は予約文字であり、JSONでは使用できません。文字列で使用するには適切にエスケープする必要があります。円記号を \\ に置き換えます。API 内のすべてのフィールドに適用されます。
要求属性
属性 | 「説明」 |
---|---|
login |
VM マネージャーにアクセスするのに使用するユーザー名。 |
password |
VM マネージャーにアクセスするのに使用するパスワード。このパスワードは、送信後に暗号化されます。 |
protocol |
VM マネージャーで使用される通信プロトコル。この属性は、Hyper-V にのみ適用できます。
|
sharecredentials |
VM マネージャーが、同じクラスター内の他のホストと資格情報を共有するかどうかを示します。この属性は、Hyper-V にのみ適用できます。
|
type |
VM マネージャーのタイプ。
|
url |
VM マネージャーの Web アドレス。完全な URL、ホスト名、または IP アドレスを指定することができます。デフォルトの URL は仮想化タイプによって異なります。
|
vmmanagerid |
変更する VM マネージャーの ID。この ID を取得するには、VM マネージャーを取得するための REST API を使用します。 |
vmmanagertoolid |
変更する VM マネージャーからデータを収集する VM Manager toolの ID。この ID を取得するには、VM マネージャーを取得するための REST API を使用します。 |
HTTP 会話の例 - VM マネージャーの追加
新しい VM マネージャーを追加するには、以下の属性を指定します。
login
password
url
type
- 要求
-
PUT http://localhost:9081/api/sam/vmmanagers ?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623 [ { "login":"user1", "password":"vZaW1Ve6", "url":"192.0.2.24", "type":2 } ]
- 応答
-
200 OK
HTTP 会話の例 - VM マネージャーの変更
既存の VM マネージャーを変更するには、以下の属性を指定します。
login
password
url
type
vmmanagerid
vmmanagertoolid
重要: 変更する属性の数に関係なく、すべての属性を要求内で指定する必要があります。
- 要求
-
PUT http://localhost:9081/api/sam/vmmanagers ?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623 [ { "vmmanagerid":1, "vmmanagertoolid":1, "login":"user1", "password":"vZaW1Ve6", "url":"192.0.2.24", "type":3 } ]
- 応答
-
200 OK