4.9. network

The network resource type groups all logical network resources in a Red Hat Enterprise Virtualization environment.

Expand

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.

Expand

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.

Expand

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

[RHEVM shell (connected)]# add network --name WebNetwork --datacenter-name Default

Copy to Clipboard

Toggle word wrap

Example 4.22. Attaching an existing network to a cluster

[RHEVM shell (connected)]# add network --name WebNetwork --datacenter-name Default --cluster-identifier Default

[RHEVM shell (connected)]# add network --name WebNetwork --datacenter-name Default --cluster-identifier Default

Copy to Clipboard

Toggle word wrap

Example 4.23. Updating a network

[RHEVM shell (connected)]# update network WebNetwork --name DataNetwork

[RHEVM shell (connected)]# update network WebNetwork --name DataNetwork

Copy to Clipboard

Toggle word wrap

Example 4.24. Deleting a network

[RHEVM shell (connected)]# remove network WebNetwork

[RHEVM shell (connected)]# remove network WebNetwork

Copy to Clipboard

Toggle word wrap