Skip to content

Conversation

@william051200
Copy link
Member

@william051200 william051200 commented Nov 21, 2025

Related command

az network application-gateway settings create
az network application-gateway settings show
az network application-gateway settings update

az network application-gateway probe create
az network application-gateway probe show
az network application-gateway probe update

Description

Resolve #32366

aaz Azure/aaz#905

Testing Guide

Settings: To create settings with value enableL4ClientIpPreservation as false by default
az network application-gateway settings create

Settings: To update settings enableL4ClientIpPreservation property value to True
az network application-gateway settings update --enable-l4-client-ip-preservation true

Probe: To create probe with value enableProbeProxyProtocolHeader false by default
az network application-gateway probe create

Settings: To update settings enableProbeProxyProtocolHeader value to True
az network application-gateway probe update --enable-probe-proxy-protocol-header true

History Notes

[Network] az network application-gateway settings: Support enableL4ClientIpPreservation property via --enable-l4-client-ip
[Network] az network application-gateway probe: Support enableProbeProxyProtocolHeader property via --enable-proxy-header


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 21, 2025 03:33
@azure-client-tools-bot-prd
Copy link

azure-client-tools-bot-prd bot commented Nov 21, 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

Hi @william051200,
Since the current milestone time is less than 7 days, this pr will be reviewed in the next milestone.

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

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

⚠️AzureCLI-BreakingChangeTest
⚠️network
rule cmd_name rule_message suggest_message
⚠️ 1006 - ParaAdd network application-gateway probe create cmd network application-gateway probe create added parameter enable_proxy_header
⚠️ 1006 - ParaAdd network application-gateway probe update cmd network application-gateway probe update added parameter enable_proxy_header
⚠️ 1006 - ParaAdd network application-gateway settings create cmd network application-gateway settings create added parameter enable_l4_client_ip
⚠️ 1006 - ParaAdd network application-gateway settings update cmd network application-gateway settings update added parameter enable_l4_client_ip

@yonzhan
Copy link
Collaborator

yonzhan commented Nov 21, 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 two new client IP preservation properties to Azure Application Gateway commands:

  • enableL4ClientIpPreservation for backend settings
  • enableProbeProxyProtocolHeader for health probes

Key Changes:

  • Added --enable-l4-client-ip-preservation parameter to settings commands (create/update)
  • Added --enable-probe-proxy-protocol-header parameter to probe commands (create/update)
  • Updated API version from 2023-11-01 to 2025-01-01 across all affected command files
  • Added comprehensive test coverage for both new properties

Reviewed Changes

Copilot reviewed 20 out of 23 changed files in this pull request and generated no comments.

Show a summary per file
File Description
test_network_commands.py Added two new test methods to verify the new properties work correctly
settings/_create.py Added enableL4ClientIpPreservation argument and schema support
settings/_update.py Added enableL4ClientIpPreservation argument and schema support
settings/_show.py Updated schema to include enableL4ClientIpPreservation property
settings/_list.py Updated schema to include enableL4ClientIpPreservation property
settings/_delete.py Updated schema to include enableL4ClientIpPreservation property
settings/_wait.py Updated schema to include enableL4ClientIpPreservation property
probe/_create.py Added enableProbeProxyProtocolHeader argument and schema support
probe/_update.py Added enableProbeProxyProtocolHeader argument and schema support
probe/_show.py Updated schema to include enableProbeProxyProtocolHeader property
probe/_list.py Updated schema to include enableProbeProxyProtocolHeader property
probe/_delete.py Updated schema to include enableProbeProxyProtocolHeader property
probe/_wait.py Updated schema to include enableProbeProxyProtocolHeader property
Various __cmd_group.py files Code cleanup: removed outdated comments and added trailing commas

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

@necusjz
Copy link
Member

necusjz commented Nov 21, 2025

from https://dev.azure.com/azclitools/public/public%20Team/_build/results?buildId=283936&view=logs&j=168ccbe3-da49-5c0b-6478-08f7016e4bf5&t=10a595be-4223-5cc7-9a73-012871b6eaee&l=191, let's come up with some shorter aliases for the new parameters.

@necusjz
Copy link
Member

necusjz commented Nov 21, 2025

insert multiple changelogs into "History Notes" section is good. however, we'd better to describe things from the user’s perspective, so it can be optimized as,

[Network] `az network application-gateway settings`: Add `--option --alias` parameter
[Network] `az network application-gateway probe`: Add `--option --alias` parameter

@necusjz
Copy link
Member

necusjz commented Nov 25, 2025

it seems we need to git rebase a little bit to make our changes clean,
image

@necusjz
Copy link
Member

necusjz commented Nov 25, 2025

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 3 pipeline(s).

@necusjz necusjz merged commit 1bb0394 into Azure:dev Nov 27, 2025
48 checks passed
@william051200 william051200 deleted the 32366-new-property branch December 26, 2025 06:22
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 Reservations az reservations

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature]: Add Client IP Preservation properties to Application Gateway Backend Settings and Probe CLI. Update Cli commands

4 participants