4.24. vnicprofile

The vnicprofile resource type groups all VNIC (virtual network interface controller) profiles, also referred to as VM (virtual machine) interface profiles, in a Red Hat Enterprise Virtualization environment.

Table 4.67. Virtual Network Interface Controller Profile Parameters

Name Type Description Required User Creatable User Updatable
--name
string
The name of the VNIC profile.
Yes
Yes
Yes
--network-id
string
A reference to the logical network to which the profile will be applied.
Yes
No
No
--correlation_id
string
A tagging identifier of an action for cross-system logging. If the client does not define the identifier, one will be generated.
No
Yes
No
--description
string
A description for the profile.
No
Yes
Yes
--expect
'201-created'
Request becomes asynchronous until the expected HTTP header is returned. Useful for long-running tasks that would otherwise return as successful before the task is completed.
No
No
No
--custom_properties-custom_property
collection
A set of user-defined environment variables passed as parameters to custom scripts.
No
Yes
Yes
--port_mirroring
Boolean
Toggles whether port mirroring is used for the profile. The status is either True or False. Default is Falses
No
No
No
The --custom_properties-custom_property parameter is a collection that uses the sub-parameters in the following table.

Table 4.68. --custom_properties-custom_property parameters

Name Type Description
custom_property.name
string
The custom property name.
custom_property.value
string
The custom property value.

Example 4.51. Creating a new vnic profile

[RHEVM shell (connected)]# add vnicprofile --name Gold --network-id 08305a2f-6952-4999-9646-c16137dc6d42

Example 4.52. Updating a vnic profile

[RHEVM shell (connected)]# update vnicprofile Gold --port_mirroring true

Example 4.53. Deleting a vnic profile

[RHEVM shell (connected)]# remove vnicprofile Gold