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.
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 False s
|
No
|
No
|
No
|
The
--custom_properties-custom_property
parameter is a collection that uses the sub-parameters in the following table.
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