AddVirtualNetwork
「 AddVirtualNetwork 」メソッドを使用して、クラスタ構成に新しい仮想ネットワークを追加できます。
仮想ネットワークを追加すると、各ノードのインターフェイスが作成され、その各インターフェイスに仮想ネットワーク IP アドレスが必要となります。この API メソッドのパラメータとして指定する IP アドレスの数は、クラスタ内のノードの数以上であることが必要です。仮想ネットワークアドレスは一括でプロビジョニングされ、個々のノードに自動的に割り当てられます。仮想ネットワークアドレスをノードに手動で割り当てる必要はありません。
AddVirtualNetwork メソッドは、新しい仮想ネットワークを作成するためだけに使用されます。既存の仮想ネットワークに変更を加える場合は、を使用します ModifyVirtualNetwork メソッド |
パラメータ
このメソッドの入力パラメータは次のとおりです。
名前 | 説明 | を入力します | デフォルト値 | 必須 |
---|---|---|---|---|
アドレスブロック |
仮想ネットワークに含める一意の IP アドレス範囲。オブジェクトの必須のメンバーは次のとおりです。
|
JSON オブジェクトの配列 |
なし |
はい。 |
属性( Attributes ) |
JSON オブジェクト形式の名前と値のペアのリスト。 |
JSON オブジェクト |
なし |
いいえ |
ゲートウェイ |
仮想ネットワークのゲートウェイの IP アドレスです。このパラメータは、 namespace パラメータを true に設定した場合のみ有効です。 |
文字列 |
なし |
いいえ |
名前 |
新しい仮想ネットワークのユーザ定義名。 |
文字列 |
なし |
はい。 |
ネームスペース |
true に設定すると、ネームスペースとそこに含まれる仮想ネットワークが作成および構成されることで、ルーティング可能ストレージ VLAN 機能が有効になります。 |
ブール値 |
なし |
いいえ |
ネットマスク |
作成中の仮想ネットワークに一意のネットワークマスク。 |
文字列 |
なし |
はい。 |
svip |
作成する仮想ネットワークに一意のストレージ IP アドレス。 |
文字列 |
なし |
はい。 |
virtualNetworkTag |
一意の仮想ネットワーク( VLAN )タグ。サポートされる値は 1~4094 です。 |
整数 |
なし |
はい。 |
-
注: * namespace を false に設定するときは、仮想ネットワークごとに仮想ネットワークのパラメータを一意にする必要があります。
戻り値
このメソッドの戻り値は次のとおりです。
名前 |
説明 |
を入力します |
virtualNetworkID |
新しい仮想ネットワークの仮想ネットワーク ID 。 |
整数 |
要求例
このメソッドの要求例を次に示します。
{ "method": "AddVirtualNetwork", "params": { "virtualNetworkTag": 2010, "name": "network1", "addressBlocks" : [ { "start": "192.86.5.1", "size": 10 }, { "start": "192.86.5.50", "size": 20 } ], "netmask" : "255.255.192.0", "gateway" : "10.0.1.254", "svip" : "192.86.5.200", "attributes" : {} "namespace" : true }, "id": 1 }
応答例
このメソッドの応答例を次に示します。
{ "id": 1, "result": { "virtualNetworkID": 5 } }
新規導入バージョン
9.6