Red Hat Training
A Red Hat training course is available for Red Hat Virtualization
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 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
