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 リンクのコピーリンクがクリップボードにコピーされました!
返すネットワークの最大数を設定します。指定されていない場合には、すべてのネットワークが返されます。