Add API to enable/disable NICs for KVM

[hsato03]

Description

This PR introduces the updateVmNic API, allowing users to enable or disable their VMs network interface cards (NICs).

Currently, this API supports only KVM with the following parameters:

Parameter	Description	Required
nicid	The ID of the NIC that will be updated	Yes
enabled	If true, sets the NIC state to Enabled; otherwise, sets the NIC state to Disabled	No

Future updates will extend this API to support additional NIC properties and hypervisors.

Types of changes

• Breaking change (fix or feature that would cause existing functionality to change)
• New feature (non-breaking change which adds functionality)
• Bug fix (non-breaking change which fixes an issue)
• Enhancement (improves an existing feature and functionality)
• Cleanup (Code refactoring and cleanup, that may add test cases)
• Build/CI
• Test (unit or integration test code)

Feature/Enhancement Scale or Bug Severity

Feature/Enhancement Scale

• Major
• Minor

Bug Severity

• BLOCKER
• Critical
• Major
• Minor
• Trivial

Screenshots (if appropriate):

How Has This Been Tested?

All tests were performed using only one NIC in the VM. Furthermore, the results of all tests were obtained using the ip a command executed inside the VM.

N	Test	Result
1	With the VM running, I changed the state of its NIC from Enabled to Disabled	The NIC was DOWN
2	With the VM running, I changed the state of its NIC from Disabled to Enabled	The NIC was UP
3	With the VM stopped, I started it with its NIC in the Enabled state	The NIC was UP
4	With the VM stopped, I started it with its NIC in the Disabled state	The NIC was DOWN

How did you try to break this feature and the system with this change?

[hsato03]

@blueorangutan package

[blueorangutan]

@hsato03 a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

[blueorangutan]

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17163

[codecov]

Codecov Report

❌ Patch coverage is 13.15789% with 198 lines in your changes missing coverage. Please review.
✅ Project coverage is 18.02%. Comparing base (93239e0) to head (39c270b).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
...n/java/com/cloud/vm/VirtualMachineManagerImpl.java	0.00%	52 Missing ⚠️
...cloudstack/api/command/user/vm/UpdateVmNicCmd.java	0.00%	32 Missing ⚠️
...urce/wrapper/LibvirtUpdateVmNicCommandWrapper.java	4.00%	24 Missing ⚠️
...n/java/com/cloud/agent/api/UpdateVmNicCommand.java	0.00%	20 Missing ⚠️
...on/src/main/java/com/cloud/vm/VmWorkUpdateNic.java	0.00%	11 Missing ⚠️
.../src/main/java/com/cloud/vm/UserVmManagerImpl.java	67.74%	7 Missing and 3 partials ⚠️
...pi/src/main/java/com/cloud/agent/api/to/NicTO.java	0.00%	6 Missing ⚠️
api/src/main/java/com/cloud/vm/NicProfile.java	14.28%	6 Missing ⚠️
...rg/apache/cloudstack/api/response/NicResponse.java	0.00%	6 Missing ⚠️
...in/java/com/cloud/agent/api/UpdateVmNicAnswer.java	0.00%	5 Missing ⚠️
... and 10 more

Additional details and impacted files

@@             Coverage Diff              @@
##               main   #12819      +/-   ##
============================================
+ Coverage     17.95%   18.02%   +0.06%     
- Complexity    16259    16453     +194     
============================================
  Files          5954     5973      +19     
  Lines        534838   537334    +2496     
  Branches      65423    65975     +552     
============================================
+ Hits          96010    96828     +818     
- Misses       428053   429584    +1531     
- Partials      10775    10922     +147     

Flag	Coverage Δ
uitests	3.53% <ø> (-0.13%)	⬇️
unittests	19.18% <13.15%> (+0.11%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[JoaoJandre]

Minor nit

[GaOrtiga]

@hsato03
Code lgtm (apart from @JoaoJandre's review)

I also tested locally by enabling/disabling the NIC and using ip a inside the VM, I also tested:

• Using the API through the UI and CMK.
• Editing the default NIC when the VM has multiple NICs.
• Editing the NIC with the VM stopped and then starting it.

Everything worked as expected.

[hsato03]

@blueorangutan package

[blueorangutan]

@hsato03 a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

[blueorangutan]

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17189