6.288. VnicProfiles
このサービスは、すべての vNIC プロファイルのコレクションを管理します。
名前 | Summary |
---|---|
| vNIC プロファイルを追加します。 |
| すべての vNIC プロファイルをリスト表示します。 |
6.288.1. add POST
vNIC プロファイルを追加します。
たとえば、vNIC プロファイル 123
をネットワーク 456
に追加するには、次の宛先にリクエストを送信します。
POST /ovirt-engine/api/networks/456/vnicprofiles
以下のボディーを使用します。
<vnic_profile id="123"> <name>new_vNIC_name</name> <pass_through> <mode>disabled</mode> </pass_through> <port_mirroring>false</port_mirroring> </vnic_profile>
各 VNIC プロファイルにはデフォルトのネットワークフィルターがあることに注意してください。デフォルトのネットワークフィルターの計算方法は、NetworkFilters のドキュメントを参照してください。
外部ネットワーク用に自動作成された vNIC プロファイルには、ネットワークフィルターがありません。
新しい VNIC プロファイル作成の出力は、指定された body 引数によって異なります。ネットワークフィルターが指定されていない場合は、デフォルトのネットワークフィルターが設定されます。以下に例を示します。
<vnic_profile href="/ovirt-engine/api/vnicprofiles/123" id="123"> <name>new_vNIC_name</name> <link href="/ovirt-engine/api/vnicprofiles/123/permissions" rel="permissions"/> <pass_through> <mode>disabled</mode> </pass_through> <port_mirroring>false</port_mirroring> <network href="/ovirt-engine/api/networks/456" id="456"/> <network_filter href="/ovirt-engine/api/networkfilters/789" id="789"/> </vnic_profile>
空のネットワークフィルターが指定された場合、VNIC プロファイルのデフォルトネットワークフィルターに関係なく、特定の VNIC プロファイルに対してネットワークフィルターは設定されません。以下に例を示します。
<vnic_profile> <name>no_network_filter</name> <network_filter/> </vnic_profile>
特定の有効なネットワークフィルター ID が指定された場合、VNIC プロファイルのデフォルトネットワークフィルターに関係なく、指定されたネットワークフィルターを使用して VNIC プロファイルが設定されます。以下に例を示します。
<vnic_profile> <name>user_choice_network_filter</name> <network_filter id= "0000001b-001b-001b-001b-0000000001d5"/> </vnic_profile>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In/Out | 追加される vNIC プロファイル。 |
6.288.2. list GET
すべての vNIC プロファイルをリスト表示します。
返される vNIC プロファイルリストの順序は保証されません。
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | たどる 必要のある内部リンクを指定します。 | |
| In | 返すプロファイルの最大数を設定します。 | |
| Out | すべての vNIC プロファイルのリスト。 |
6.288.2.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.288.2.2. max
返すプロファイルの最大数を設定します。指定されていない場合は、すべてのプロファイルが返されます。