11.5. サブコレクション

11.5.1. ネットワーク VNIC プロファイルのサブコレクション

VNIC (Virtual Network Interface Controller) プロファイル (別称: 仮想マシンインターフェースプロファイル) は、ユーザーやグループに適用してネットワーク帯域幅を制限するためのカスタマイズされたプロファイルです。各 vnicprofile には以下のような要素が含まれています。

表11.2 VNIC プロファイルの要素

要素タイプ説明
name文字列プロファイルの一意識別子
description文字列プレーンテキストで記述されたプロファイルの説明
network文字列プロファイルが適用される論理ネットワークの一意識別子
port_mirroringブール値: true または falseデフォルトは false です。

例11.6 ネットワークの vnicprofile サブコレクションの XML 表現

<vnic_profile href= "/api/vnicprofiles/f9c2f9f1-3ae2-4100-a9a5-285ebb755c0d" id="f9c2f9f1-3ae2-4100-a9a5-285ebb755c0d">
	<name>Peanuts</name>
	<description>shelled</description>
	<network href= "/api/networks/00000000-0000-0000-0000-000000000009" id="00000000-0000-0000-0000-000000000009"/>
	<port_mirroring>false</port_mirroring>
	</vnic_profile>
</vnic_profiles>

11.5.2. ネットワークラベルのサブコレクション

ネットワークラベルはプレーンテキスト形式の人間が判読できるラベルで、物理ホストのネットワークインターフェースと論理ネットワークを自動的に関連付けることができます。各 label には以下の要素が含まれています。

表11.3 ラベルの要素

要素タイプ説明
network文字列ラベルを付けるネットワークの href と id です。

例11.7 ネットワークのラベルサブコレクションの XML 表現

<labels>
  <label href="/api/networks/00000000-0000-0000-0000-000000000000/labels/eth0" id="eth0">
    <network href="/api/networks/00000000-0000-0000-0000-000000000000"
      id="00000000-0000-0000-0000-000000000000"/>
  </label>
</labels>

11.5.3. メソッド

11.5.3.1. 論理ネットワークにラベルを付けるアクション

論理ネットワークにラベルをつけて、同じラベルを付けたホストのネットワークインターフェースと論理ネットワークを自動的に関連付けることができます。

例11.8 論理ネットワークにラベルを付けるアクション

POST /api/networks/00000000-0000-0000-0000-000000000000/labels/ HTTP/1.1
Accept: application/xml
Content-type: application/xml

<label id="Label_001" />

11.5.3.2. 論理ネットワークからのラベルの削除

論理ネットワークからラベルを削除するには DELETE 要求が必要です。

例11.9 論理ネットワークからのラベルの削除

DELETE /api/networks/00000000-0000-0000-0000-000000000000/labels/[label_id] HTTP/1.1

HTTP/1.1 204 No Content