6.152. Networks
論理ネットワークを管理します。
エンジンは、インストール時にデフォルトの ovirtmgmt
ネットワークを作成します。このネットワークは、ハイパーバイザーホストにアクセスするための管理ネットワークとして機能します。このネットワークは Default
クラスターに関連付けられており、Default
データセンターのメンバーです。
名前 | Summary |
---|---|
| 新しい論理ネットワークを作成するか、既存のネットワークをデータセンターに関連付けます。 |
| 論理ネットワークをリスト表示します。 |
6.152.1. add POST
新しい論理ネットワークを作成するか、既存のネットワークをデータセンターに関連付けます。
新しいネットワークの作成には、name
要素と data_center
要素が必要です。
たとえば、データセンター 123
用に mynetwork
という名前のネットワークを作成するには、以下のような要求を送信します。
POST /ovirt-engine/api/networks
リクエスト本文は以下のようになります。
<network> <name>mynetwork</name> <data_center id="123"/> </network>
既存のネットワーク 456
をデータセンター 123
に関連付けるには、以下のような要求を送信します。
POST /ovirt-engine/api/datacenters/123/networks
リクエスト本文は以下のようになります。
<network> <name>ovirtmgmt</name> </network>
外部 OpenStack ネットワークプロバイダー 456
の上に exnetwork
という名前のネットワークを作成するには、以下のようなリクエストを送信します。
POST /ovirt-engine/api/networks
<network> <name>exnetwork</name> <external_provider id="456"/> <data_center id="123"/> </network>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In/Out |
6.152.2. list GET
論理ネットワークをリスト表示します。
以下に例を示します。
GET /ovirt-engine/api/networks
以下を応答します。
<networks> <network href="/ovirt-engine/api/networks/123" id="123"> <name>ovirtmgmt</name> <description>Default Management Network</description> <link href="/ovirt-engine/api/networks/123/permissions" rel="permissions"/> <link href="/ovirt-engine/api/networks/123/vnicprofiles" rel="vnicprofiles"/> <link href="/ovirt-engine/api/networks/123/networklabels" rel="networklabels"/> <mtu>0</mtu> <stp>false</stp> <usages> <usage>vm</usage> </usages> <data_center href="/ovirt-engine/api/datacenters/456" id="456"/> </network> ... </networks>
返されるネットワークのリストの順序は、sortby
句が search
パラメーターに含まれている場合にのみ保証されます。
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In |
| |
| In | たどる 必要のある内部リンクを指定します。 | |
| In | 返すネットワークの最大数を設定します。 | |
| Out | ||
| In | 返されたホストを制限するために使用されるクエリー文字列。 |
6.152.2.1. case_sensitive
search
パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true
です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false
に設定します。
6.152.2.2. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.152.2.3. max
返すネットワークの最大数を設定します。指定されていない場合には、すべてのネットワークが返されます。