4.9. network
The
network resource type groups all logical network resources in a Red Hat Enterprise Virtualization environment.
Table 4.21. Logical network parameters
| Name | Type | Description | Required | User Creatable | User Updatable |
|---|---|---|---|---|---|
--data_center-id|name
|
string
|
A reference to the data center for a logical network.
|
Yes
|
Yes
|
No
|
--name
|
string
|
A plain text name for the logical network.
|
Yes
|
Yes
|
No
|
--description
|
string
|
A description for the logical network.
|
No
|
Yes
|
Yes
|
--vlan-id
|
string
|
A VLAN tag.
|
No
|
Yes
|
Yes
|
--ip-address
|
string
|
The IP address for the logical network's bridge.
|
No
|
Yes
|
Yes
|
--ip-gateway
|
string
|
The gateway for the logical network's bridge.
|
No
|
Yes
|
Yes
|
--ip-netmask
|
string
|
The netmask for the logical network's bridge.
|
No
|
Yes
|
Yes
|
--display
|
boolean
|
Signifies if a logical network is used for display communication usage. Set to either
true or false.
|
No
|
Yes
|
Yes
|
--stp
|
boolean
|
Set to
true if Spanning Tree Protocol is enabled on this network.
|
No
|
Yes
|
Yes
|
--mtu
|
int
|
Sets a user-defined value for the maximum transmission unit of the logical network.
|
No
|
Yes
|
Yes
|
--usages-usage
|
collection
|
Defines usage parameters for the logical network.
|
No
|
No
|
Yes
|
The
--usages-usage parameter is a collection that uses the sub-parameters in the following table.
Table 4.22. usages-usage parameters
| Name | Type | Description |
|---|---|---|
usage
|
string
|
Usage types for the network. Options include
VM and DISPLAY.
|
The following table lists additional
network options for resource-based commands.
Table 4.23. Additional command options
| Option | Description |
|---|---|
--cluster-identifier | Adds the network to a cluster as a sub-resource. |
Example 4.21. Creating a new network
[RHEVM shell (connected)]# add network --name WebNetwork --datacenter-name Default
Example 4.22. Attaching an existing network to a cluster
[RHEVM shell (connected)]# add network --name WebNetwork --datacenter-name Default --cluster-identifier Default
Example 4.23. Updating a network
[RHEVM shell (connected)]# update network WebNetwork --name DataNetwork
Example 4.24. Deleting a network
[RHEVM shell (connected)]# remove network WebNetwork
