Skip to content

Conversation

@huiii99
Copy link
Member

@huiii99 huiii99 commented Nov 27, 2025

Related command
az network virtual-appliance create
az network virtual-appliance update
az network virtual-appliance show

Description
Add support for NvaInterfaceConfiguration in network virtual-appliance command group.

  • Introduced new parameter --interface-config for create and update commands.
  • Updated show command to display interfaceConfigurations properties.

Resolve #32413
aaz Azure/aaz#907

Testing Guide

  • live test:
    azdev test NetworkVirtualApplianceVnetScenarioTest --live --discover
  • playback test after recording:
    azdev test NetworkVirtualApplianceVnetScenarioTest

History Notes


This checklist is used to make sure that common guidelines for a pull request are followed.

Copilot AI review requested due to automatic review settings November 27, 2025 06:24
@azure-client-tools-bot-prd
Copy link

azure-client-tools-bot-prd bot commented Nov 27, 2025

️✔️AzureCLI-FullTest
️✔️acr
️✔️latest
️✔️3.12
️✔️3.13
️✔️acs
️✔️latest
️✔️3.12
️✔️3.13
️✔️advisor
️✔️latest
️✔️3.12
️✔️3.13
️✔️ams
️✔️latest
️✔️3.12
️✔️3.13
️✔️apim
️✔️latest
️✔️3.12
️✔️3.13
️✔️appconfig
️✔️latest
️✔️3.12
️✔️3.13
️✔️appservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️aro
️✔️latest
️✔️3.12
️✔️3.13
️✔️backup
️✔️latest
️✔️3.12
️✔️3.13
️✔️batch
️✔️latest
️✔️3.12
️✔️3.13
️✔️batchai
️✔️latest
️✔️3.12
️✔️3.13
️✔️billing
️✔️latest
️✔️3.12
️✔️3.13
️✔️botservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️cdn
️✔️latest
️✔️3.12
️✔️3.13
️✔️cloud
️✔️latest
️✔️3.12
️✔️3.13
️✔️cognitiveservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️compute_recommender
️✔️latest
️✔️3.12
️✔️3.13
️✔️computefleet
️✔️latest
️✔️3.12
️✔️3.13
️✔️config
️✔️latest
️✔️3.12
️✔️3.13
️✔️configure
️✔️latest
️✔️3.12
️✔️3.13
️✔️consumption
️✔️latest
️✔️3.12
️✔️3.13
️✔️container
️✔️latest
️✔️3.12
️✔️3.13
️✔️containerapp
️✔️latest
️✔️3.12
️✔️3.13
️✔️core
️✔️latest
️✔️3.12
️✔️3.13
️✔️cosmosdb
️✔️latest
️✔️3.12
️✔️3.13
️✔️databoxedge
️✔️latest
️✔️3.12
️✔️3.13
️✔️dls
️✔️latest
️✔️3.12
️✔️3.13
️✔️dms
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventgrid
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventhubs
️✔️latest
️✔️3.12
️✔️3.13
️✔️feedback
️✔️latest
️✔️3.12
️✔️3.13
️✔️find
️✔️latest
️✔️3.12
️✔️3.13
️✔️hdinsight
️✔️latest
️✔️3.12
️✔️3.13
️✔️identity
️✔️latest
️✔️3.12
️✔️3.13
️✔️iot
️✔️latest
️✔️3.12
️✔️3.13
️✔️keyvault
️✔️latest
️✔️3.12
️✔️3.13
️✔️lab
️✔️latest
️✔️3.12
️✔️3.13
️✔️managedservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️maps
️✔️latest
️✔️3.12
️✔️3.13
️✔️marketplaceordering
️✔️latest
️✔️3.12
️✔️3.13
️✔️monitor
️✔️latest
️✔️3.12
️✔️3.13
️✔️mysql
️✔️latest
️✔️3.12
️✔️3.13
️✔️netappfiles
️✔️latest
️✔️3.12
️✔️3.13
️✔️network
️✔️latest
️✔️3.12
️✔️3.13
️✔️policyinsights
️✔️latest
️✔️3.12
️✔️3.13
️✔️privatedns
️✔️latest
️✔️3.12
️✔️3.13
️✔️profile
️✔️latest
️✔️3.12
️✔️3.13
️✔️rdbms
️✔️latest
️✔️3.12
️✔️3.13
️✔️redis
️✔️latest
️✔️3.12
️✔️3.13
️✔️relay
️✔️latest
️✔️3.12
️✔️3.13
️✔️resource
️✔️latest
️✔️3.12
️✔️3.13
️✔️role
️✔️latest
️✔️3.12
️✔️3.13
️✔️search
️✔️latest
️✔️3.12
️✔️3.13
️✔️security
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicebus
️✔️latest
️✔️3.12
️✔️3.13
️✔️serviceconnector
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicefabric
️✔️latest
️✔️3.12
️✔️3.13
️✔️signalr
️✔️latest
️✔️3.12
️✔️3.13
️✔️sql
️✔️latest
️✔️3.12
️✔️3.13
️✔️sqlvm
️✔️latest
️✔️3.12
️✔️3.13
️✔️storage
️✔️latest
️✔️3.12
️✔️3.13
️✔️synapse
️✔️latest
️✔️3.12
️✔️3.13
️✔️telemetry
️✔️latest
️✔️3.12
️✔️3.13
️✔️util
️✔️latest
️✔️3.12
️✔️3.13
️✔️vm
️✔️latest
️✔️3.12
️✔️3.13

@azure-client-tools-bot-prd
Copy link

azure-client-tools-bot-prd bot commented Nov 27, 2025

⚠️AzureCLI-BreakingChangeTest
⚠️network
rule cmd_name rule_message suggest_message
⚠️ 1006 - ParaAdd network virtual-appliance create cmd network virtual-appliance create added parameter nva_interface_configurations
⚠️ 1010 - ParaPropUpdate network virtual-appliance create cmd network virtual-appliance create update parameter internet_ingress_public_ips: updated property name from internet_ingress_public_ips to internet_ingress_ips
⚠️ 1011 - SubgroupAdd network virtual-appliance identity sub group network virtual-appliance identity added
⚠️ 1006 - ParaAdd network virtual-appliance update cmd network virtual-appliance update added parameter nva_interface_configurations
⚠️ 1010 - ParaPropUpdate network virtual-appliance update cmd network virtual-appliance update update parameter internet_ingress_public_ips: updated property name from internet_ingress_public_ips to internet_ingress_ips

@yonzhan
Copy link
Collaborator

yonzhan commented Nov 27, 2025

Thank you for your contribution! We will review the pull request and get back to you soon.

@github-actions
Copy link

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds support for NvaInterfaceConfiguration in the network virtual-appliance command group, enabling deployment of Network Virtual Appliances (NVAs) in Virtual Networks using interface configurations. The changes include:

  • Introduction of the --interface-config parameter for create and update commands
  • Update to API version 2024-10-01 from 2023-11-01
  • Addition of identity management subcommands (assign, remove, show, wait)
  • New test scenario for VNet-based NVA deployment with interface configurations

Reviewed changes

Copilot reviewed 16 out of 17 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
test_network_commands.py Adds comprehensive test for NVA VNet deployment with interface configurations, including provisioning checks and retry logic
nva-interface-config-example.json Provides example JSON structure for interface configuration with two NICs (private and public)
identity/* (5 files) Auto-generated AAZ files for new identity management subcommands
_create.py, _update.py, _show.py, _list.py, _wait.py, _delete.py, _reimage.py Updated to API version 2024-10-01 with schema changes for nvaInterfaceConfigurations
_help.py Adds help documentation for the create command with interface-config parameter examples

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

@necusjz
Copy link
Member

necusjz commented Nov 28, 2025

for the "single" feature request, we don't need to modify History Notes section:
image

but instead use the pull request title to represent the changelog.

@necusjz
Copy link
Member

necusjz commented Nov 28, 2025

❌AzureCLI-BreakingChangeTest

❌network

rule
cmd_name
rule_message
suggest_message

1007 - ParaRemove
network virtual-appliance create
cmd network virtual-appliance create removed parameter identity
please add back parameter identity for cmd network virtual-appliance create

1010 - ParaPropUpdate
network virtual-appliance create
cmd network virtual-appliance create update parameter internet_ingress_public_ips: updated property options from ['--internet-ingress-ips'] to ['--internet-ingress-public-ips']
please change property options from ['--internet-ingress-public-ips'] to ['--internet-ingress-ips'] for parameter internet_ingress_public_ips of cmd network virtual-appliance create

1010 - ParaPropUpdate
network virtual-appliance reimage
cmd network virtual-appliance reimage update parameter network_virtual_appliance_name: updated property options from ['--name', '--network-virtual-appliance-name', '-n'] to ['--network-virtual-appliance-name']
please change property options from ['--network-virtual-appliance-name'] to ['--name', '--network-virtual-appliance-name', '-n'] for parameter network_virtual_appliance_name of cmd network virtual-appliance reimage

1007 - ParaRemove
network virtual-appliance update
cmd network virtual-appliance update removed parameter identity
please add back parameter identity for cmd network virtual-appliance update

1010 - ParaPropUpdate
network virtual-appliance update
cmd network virtual-appliance update update parameter internet_ingress_public_ips: updated property options from ['--internet-ingress-ips'] to ['--internet-ingress-public-ips']
please change property options from ['--internet-ingress-public-ips'] to ['--internet-ingress-ips'] for parameter internet_ingress_public_ips of cmd network virtual-appliance update

⚠️ 1006 - ParaAdd
network virtual-appliance create
cmd network virtual-appliance create added parameter nva_interface_configurations

⚠️ 1011 - SubgroupAdd
network virtual-appliance identity
sub group network virtual-appliance identity added

⚠️ 1006 - ParaAdd
network virtual-appliance update
cmd network virtual-appliance update added parameter nva_interface_configurations

Please submit your Breaking Change Pre-announcement ASAP if you haven't already. Please note:

  • Breaking changes can only be merged during the designated breaking change window
  • A pre-announcement must be released at least one month in advance

For more details on how to introduce breaking changes, refer to the documentation: azure-cli/doc/how_to_introduce_breaking_changes.md

this breaking-changes checking tool is very important for ensuring the quality of our pull requests. we need to make sure there are no breaking changes whenever possible, unless we intentionally decide to introduce them.

@necusjz necusjz changed the title {Network} Add Support NvaInterfaceConfiguration in network virtual-appliance [Network] az network virtual-appliance: Add --nva-interface-configurations parameter Nov 28, 2025
@huiii99 huiii99 requested a review from zhoxing-ms as a code owner December 4, 2025 09:08
@huiii99 huiii99 force-pushed the network-nva-vnet-support branch from a4fa492 to 6349d7b Compare December 5, 2025 00:54
@necusjz necusjz merged commit 6663409 into Azure:dev Dec 5, 2025
48 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Auto-Assign Auto assign by bot

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Enable VNet support for NetworkVirtualAppliances.

3 participants