[FrontDoor] Upgrade to API version 2025-11-01#29442
Open
Ptnan7 wants to merge 4 commits intoAzure:mainfrom
Open
[FrontDoor] Upgrade to API version 2025-11-01#29442Ptnan7 wants to merge 4 commits intoAzure:mainfrom
Ptnan7 wants to merge 4 commits intoAzure:mainfrom
Conversation
- Regenerate FrontDoor.Autorest module against Microsoft.Network/frontdoor 2025-11-01 swagger.
| Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR regenerates the Az.FrontDoor AutoRest submodule against the Microsoft.Network/frontdoor 2025-11-01 API version, updating UX metadata and refreshing exported cmdlets/help/docs/tests to match the new swagger surface.
Changes:
- Updated FrontDoor AutoRest configuration/UX files to use
apiVersion: 2025-11-01and a new pinned swagger commit. - Added new cmdlets (and corresponding help/docs/examples/tests stubs) for Network Experiment Profiles/Experiments and reporting endpoints.
- Updated module manifest exports and various help text/parameter descriptions.
Reviewed changes
Copilot reviewed 89 out of 89 changed files in this pull request and generated 15 comments.
Show a summary per file
| File | Description |
|---|---|
| src/FrontDoor/FrontDoor/help/Update-AzFrontDoorNetworkExperimentProfile.md | New help page for Update cmdlet (NetworkExperimentProfiles). |
| src/FrontDoor/FrontDoor/help/Update-AzFrontDoorExperiment.md | New help page for Update Experiment cmdlet. |
| src/FrontDoor/FrontDoor/help/Set-AzFrontDoorRulesEngine.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/Set-AzFrontDoorNetworkExperimentProfile.md | New help page for Set NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor/help/Set-AzFrontDoorExperiment.md | New help page for Set Experiment cmdlet. |
| src/FrontDoor/FrontDoor/help/Remove-AzFrontDoorWafPolicy.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/Remove-AzFrontDoorRulesEngine.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/Remove-AzFrontDoorNetworkExperimentProfile.md | New help page for Remove NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor/help/Remove-AzFrontDoorExperiment.md | New help page for Remove Experiment cmdlet. |
| src/FrontDoor/FrontDoor/help/Remove-AzFrontDoorContent.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/Remove-AzFrontDoor.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/New-AzFrontDoorRulesEngine.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/New-AzFrontDoorNetworkExperimentProfile.md | New help page for New NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor/help/New-AzFrontDoorExperiment.md | New help page for New Experiment cmdlet. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorWafPolicy.md | Help updates incl. parameter set labeling and parameter descriptions. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorWafManagedRuleSetDefinition.md | Updated SubscriptionId description wording. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorRulesEngine.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorReportTimesery.md | New help page for report timeseries cmdlet. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorReportLatencyScorecard.md | New help page for report latency scorecard cmdlet. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorPreconfiguredEndpoint.md | New help page for preconfigured endpoints cmdlet. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorNetworkExperimentProfile.md | New help page for NetworkExperimentProfile Get/List cmdlet. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoorExperiment.md | New help page for Experiment Get/List cmdlet. |
| src/FrontDoor/FrontDoor/help/Get-AzFrontDoor.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/Disable-AzFrontDoorCustomDomainHttps.md | Updated parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor/help/Az.FrontDoor.md | Help index updated to include newly exported cmdlets. |
| src/FrontDoor/FrontDoor/Az.FrontDoor.psd1 | Manifest updates: required Az.Accounts min version, exports list, formatting tweaks. |
| src/FrontDoor/FrontDoor.sln | Updated project GUID entry for Az.FrontDoor project in solution. |
| src/FrontDoor/FrontDoor.Autorest/test/Update-AzFrontDoorNetworkExperimentProfile.Tests.ps1 | New Pester stub for Update NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Update-AzFrontDoorExperiment.Tests.ps1 | New Pester stub for Update Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Set-AzFrontDoorNetworkExperimentProfile.Tests.ps1 | New Pester stub for Set NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Set-AzFrontDoorExperiment.Tests.ps1 | New Pester stub for Set Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Remove-AzFrontDoorNetworkExperimentProfile.Tests.ps1 | New Pester stub for Remove NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Remove-AzFrontDoorExperiment.Tests.ps1 | New Pester stub for Remove Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/New-AzFrontDoorNetworkExperimentProfile.Tests.ps1 | New Pester stub for New NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/New-AzFrontDoorExperiment.Tests.ps1 | New Pester stub for New Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Get-AzFrontDoorReportTimesery.Tests.ps1 | New Pester stub for report timeseries cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Get-AzFrontDoorReportLatencyScorecard.Tests.ps1 | New Pester stub for latency scorecard cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Get-AzFrontDoorPreconfiguredEndpoint.Tests.ps1 | New Pester stub for preconfigured endpoints cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Get-AzFrontDoorNetworkExperimentProfile.Tests.ps1 | New Pester stub for NetworkExperimentProfile Get/List cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/test/Get-AzFrontDoorExperiment.Tests.ps1 | New Pester stub for Experiment Get/List cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/generate-info.json | Removed generation tracking file for the AutoRest module. |
| src/FrontDoor/FrontDoor.Autorest/examples/Update-AzFrontDoorNetworkExperimentProfile.md | New example stub file for Update NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Update-AzFrontDoorExperiment.md | New example stub file for Update Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Set-AzFrontDoorNetworkExperimentProfile.md | New example stub file for Set NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Set-AzFrontDoorExperiment.md | New example stub file for Set Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Remove-AzFrontDoorNetworkExperimentProfile.md | New example stub file for Remove NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Remove-AzFrontDoorExperiment.md | New example stub file for Remove Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/README.md | Added examples folder README describing purpose/workflow. |
| src/FrontDoor/FrontDoor.Autorest/examples/New-AzFrontDoorNetworkExperimentProfile.md | New example stub file for New NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/New-AzFrontDoorExperiment.md | New example stub file for New Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Get-AzFrontDoorReportTimesery.md | New example stub file for report timeseries cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Get-AzFrontDoorReportLatencyScorecard.md | New example stub file for latency scorecard cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Get-AzFrontDoorPreconfiguredEndpoint.md | New example stub file for preconfigured endpoints cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Get-AzFrontDoorNetworkExperimentProfile.md | New example stub file for NetworkExperimentProfile Get/List cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/examples/Get-AzFrontDoorExperiment.md | New example stub file for Experiment Get/List cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Update-AzFrontDoorNetworkExperimentProfile.md | New generated docs page for Update NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Update-AzFrontDoorExperiment.md | New generated docs page for Update Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Set-AzFrontDoorRulesEngine.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Set-AzFrontDoorNetworkExperimentProfile.md | New generated docs page for Set NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Set-AzFrontDoorExperiment.md | New generated docs page for Set Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Remove-AzFrontDoorWafPolicy.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Remove-AzFrontDoorRulesEngine.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Remove-AzFrontDoorNetworkExperimentProfile.md | New generated docs page for Remove NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Remove-AzFrontDoorExperiment.md | New generated docs page for Remove Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Remove-AzFrontDoorContent.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Remove-AzFrontDoor.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/New-AzFrontDoorRulesEngine.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/New-AzFrontDoorNetworkExperimentProfile.md | New generated docs page for New NetworkExperimentProfile cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/New-AzFrontDoorExperiment.md | New generated docs page for New Experiment cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorWafPolicy.md | Docs updates incl. parameter set labeling and descriptions. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorWafManagedRuleSetDefinition.md | Updated docs SubscriptionId description wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorRulesEngine.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorReportTimesery.md | New generated docs page for report timeseries cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorReportLatencyScorecard.md | New generated docs page for latency scorecard cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorPreconfiguredEndpoint.md | New generated docs page for preconfigured endpoints cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorNetworkExperimentProfile.md | New generated docs page for NetworkExperimentProfile Get/List cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoorExperiment.md | New generated docs page for Experiment Get/List cmdlet. |
| src/FrontDoor/FrontDoor.Autorest/docs/Get-AzFrontDoor.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Disable-AzFrontDoorCustomDomainHttps.md | Updated docs parameter descriptions to standard wording. |
| src/FrontDoor/FrontDoor.Autorest/docs/Az.FrontDoor.md | Docs index updated and module GUID changed in docs front-matter. |
| src/FrontDoor/FrontDoor.Autorest/custom/autogen-model-cmdlets/New-AzFrontDoorWafMatchConditionObject.ps1 | Expanded argument completer options for match variable/operator. |
| src/FrontDoor/FrontDoor.Autorest/UX/Microsoft.Network/frontDoors.json | Updated UX apiVersion to 2025-11-01. |
| src/FrontDoor/FrontDoor.Autorest/UX/Microsoft.Network/frontDoors-rulesEngines.json | Updated UX apiVersion to 2025-11-01. |
| src/FrontDoor/FrontDoor.Autorest/UX/Microsoft.Network/frontDoors-frontendEndpoints.json | Updated UX apiVersion to 2025-11-01. |
| src/FrontDoor/FrontDoor.Autorest/UX/Microsoft.Network/NetworkExperimentProfiles.json | New UX metadata for NetworkExperimentProfiles endpoints/cmdlets. |
| src/FrontDoor/FrontDoor.Autorest/UX/Microsoft.Network/NetworkExperimentProfiles-Experiments.json | New UX metadata for Experiments under NetworkExperimentProfiles. |
| src/FrontDoor/FrontDoor.Autorest/UX/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies.json | Updated UX apiVersion to 2025-11-01. |
| src/FrontDoor/FrontDoor.Autorest/README.md | Updated pinned swagger commit and input-file path for regeneration. |
| src/FrontDoor/FrontDoor.Autorest/Properties/AssemblyInfo.cs | Regenerated assembly version attributes. |
Comment on lines
28
to
+38
|
|
||
| ```yaml | ||
| # pin the swagger version by using the commit id instead of branch name | ||
| commit: 03253947022beee13bf4782c4ebef93a0afa237b | ||
| commit: 3a617d58ce1d84caade01a3a682ec5c06a9088d9 | ||
| require: | ||
| # readme.azure.noprofile.md is the common configuration file | ||
| - $(this-folder)/../../readme.azure.noprofile.md | ||
| # If the swagger has not been put in the repo, you may uncomment the following line and refer to it locally | ||
| input-file: | ||
| # You need to specify your swagger files here. | ||
| - $(repo)/specification/frontdoor/resource-manager/Microsoft.Network/stable/2025-10-01/webapplicationfirewall.json | ||
| - $(repo)/specification/frontdoor/resource-manager/Microsoft.Network/stable/2025-10-01/network.json | ||
| - $(repo)/specification/frontdoor/resource-manager/Microsoft.Network/stable/2025-10-01/frontdoor.json | ||
| - $(repo)/specification/frontdoor/resource-manager/Microsoft.Network/FrontDoor/stable/2025-11-01/openapi.json |
There was a problem hiding this comment.
src/FrontDoor/FrontDoor.Autorest/generate-info.json appears to have been removed in this PR. Repo tooling expects this file to exist for each *.Autorest module (generation tracking / outdated submodule detection) and some scripts can fail if it's missing. Please restore/regenerate generate-info.json in the module root as part of this update.
Collaborator
|
/azp run |
Contributor
|
Azure Pipelines successfully started running 3 pipeline(s). |
… cmdlets Add 'hide: true' directives for the new cmdlet subjects introduced by the 2025-11-01 swagger that are not part of the public Az.FrontDoor surface: NetworkExperimentProfile, Experiment, PreconfiguredEndpoint, ReportLatencyScorecard, ReportTimesery.
Collaborator
|
/azp run |
Contributor
|
Azure Pipelines successfully started running 3 pipeline(s). |
|
To the author of the pull request, |
Comment on lines
+21
to
+23
| * Upgraded API version to 2025-11-01. | ||
| * Hid newly introduced `NetworkExperimentProfile`, `Experiment`, `PreconfiguredEndpoint`, `ReportLatencyScorecard`, and `ReportTimesery` cmdlets that are not part of the public Az.FrontDoor surface area. | ||
| * Fixed `New-AzFrontDoorWafPolicy` / `Remove-AzFrontDoorWafPolicy` failing with `UriFormatException: Invalid URI: The URI is empty.` by rewriting the long-running-operation `final-state-via` from `location` to `original-uri` on WAF `Policies_CreateOrUpdate` and `Policies_Delete` (the service returns the terminal state synchronously and does not emit a `Location` header). |
There was a problem hiding this comment.
The new ChangeLog entries are very implementation-specific (e.g., describing final-state-via rewrites and swagger operation names) and include unexplained abbreviations like “WAF”. ChangeLog.md is user-facing; please rephrase these bullets in terms of user impact (what scenarios were failing / what behavior changed), expand WAF on first use (Web Application Firewall), and avoid internal AutoRest/swagger details. Also, the items listed as hidden “cmdlets” (e.g., Experiment, PreconfiguredEndpoint) are not verb-noun cmdlet names—either list the actual cmdlet names being hidden or describe them as API operations/resources instead of cmdlets.
Collaborator
|
/azp run |
Contributor
|
Azure Pipelines successfully started running 3 pipeline(s). |
Collaborator
|
/azp run |
Contributor
|
Azure Pipelines successfully started running 3 pipeline(s). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Mandatory Checklist
Please choose the target release of Azure PowerShell. (⚠️ Target release is a different concept from API readiness. Please click below links for details.)
Check this box to confirm: I have read the Submitting Changes section of
CONTRIBUTING.mdand reviewed the following information:ChangeLog.mdfile(s) appropriatelysrc/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.## Upcoming Releaseheader in the past tense.ChangeLog.mdif no new release is required, such as fixing test case only.