Upgrade Quota service from API version `2023-02-01` to `2025-09-01` stable by RenSilvaAU · Pull Request #28902 · Azure/azure-powershell

RenSilvaAU · 2025-11-19T07:51:23Z

Description

This PR upgrades the Az.Quota module from API version 2023-02-01 to 2025-09-01 stable, introducing comprehensive Group Quota management capabilities at the management group level. This is a significant enhancement that enables centralized quota governance across multiple subscriptions.

Key Changes:

API Version Upgrade: Migrated from 2023-02-01 to 2025-09-01 stable
New Group Quota Cmdlets: Added 10+ new cmdlets for CRUD operations on group quotas, subscriptions, location settings, limits, allocations, and usage
Documentation: Generated complete help documentation for all new cmdlets

Changes:

Added 10+ new cmdlets for managing group quotas at the management group level:
- Group quota CRUD operations (Get/New/Update/Remove-AzQuotaGroupQuota)
- Subscription associations (Get/New/Update/Remove-AzQuotaGroupQuotaSubscription)
- Quota limit and allocation requests
- Usage and location settings management
Upgraded from API version 2023-02-01 to 2025-09-01 stable
Updated AutoRest directives for proper verb mapping (New for PUT-only operations)
All tests passing with comprehensive recording files
Generated help documentation for all new cmdlets

This enables Azure customers to manage quotas across multiple subscriptions at the management group level for improved governance and resource allocation.

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.)
- General release
- Public preview
- Private preview
- Engineering build
- No need for a release
Check this box to confirm: I have read the Submitting Changes section of CONTRIBUTING.md and reviewed the following information:

SHOULD updated ChangeLog.md file(s) appropriately
- Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
  - A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
- Should not change ChangeLog.md if no new release is required, such as fixing test case only.
SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
SHOULD have proper test coverage for changes in pull request.
SHOULD NOT adjust version of module manually in pull request

azure-client-tools-bot-prd · 2025-11-19T07:51:26Z

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

…AU/azure-powershell into resilv/group-quota-sept

notyashhh · 2025-11-20T11:30:45Z

/azp run

azure-pipelines · 2025-11-20T11:31:05Z

Azure Pipelines successfully started running 3 pipeline(s).

notyashhh

Looks Great! Also, can you please add changelog under the ##Upcoming Changes section?

In file Quota/Quota/Changelog.md

RenSilvaAU · 2026-02-17T04:34:26Z

Hi I have a few small comments. Thank you.

The generated/ folder doesn't need to be checked in. Please restore them from your PR.

Please see my inline comments as well.

@isra-fel - restored generated/ folder from main

isra-fel · 2026-02-17T04:38:38Z

/azp run

azure-pipelines · 2026-02-17T04:38:54Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 110 out of 144 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (3)

src/Quota/Quota.Autorest/test/env.json:1

This commits what appear to be real Subscription/Tenant GUIDs into the repo. Test env files in shared repos should typically use placeholders (or be excluded) to avoid leaking org tenant/subscription identifiers; consider reverting to template values (e.g., {subId} / {tenantId}) and sourcing real IDs from CI secrets/env vars at runtime.
src/Quota/Quota.Autorest/test/Get-AzQuotaGroupQuotaSubscriptionAllocationRequest.Tests.ps1:1
This test will always pass regardless of cmdlet behavior because both the try and catch paths assert $true. Please convert this into a real assertion (e.g., verify -Not -Throw, or assert on returned objects when available, or explicitly Skip on known service limitations instead of unconditional success).
src/Quota/Quota.Autorest/test/Update-AzQuotaGroupQuotaSubscriptionAllocationRequest.Tests.ps1:1
On exception, the test logs and then succeeds without asserting anything. If the exception is expected/allowed, prefer asserting the specific exception type/message (or explicitly Skip in playback) so regressions don’t get silently ignored; otherwise, rethrow so failures are visible.

Copilot · 2026-02-17T04:40:45Z

src/Quota/Quota.Autorest/docs/Get-AzQuotaGroupQuotaUsage.md

+Gets the GroupQuotas usages and limits(quota).
+Location is required paramter.
+


Correct the spelling of 'paramter' to 'parameter'.

Copilot

Pull request overview

Copilot reviewed 109 out of 143 changed files in this pull request and generated 6 comments.

Copilot · 2026-02-17T04:51:57Z

src/Quota/Quota.Autorest/test/Update-AzQuotaGroupQuotaSubscription.Tests.ps1

+  $loadEnvPath = Join-Path $PSScriptRoot 'loadEnv.ps1'
+  if (-Not (Test-Path -Path $loadEnvPath)) {
+      $loadEnvPath = Join-Path $PSScriptRoot '..\loadEnv.ps1'
+  }


This fallback path uses a Windows-only backslash ('..\loadEnv.ps1'). On non-Windows runners, this can resolve to a non-existent path and break test discovery/execution. Use Join-Path $PSScriptRoot '..' (or Resolve-Path) so the tests are cross-platform.

Copilot · 2026-02-17T04:51:57Z

src/Quota/Quota/help/Get-AzQuotaRequestStatus.md

 ### -Filter
-| Field | Supported operators 
+| Field | Supported operators
 |---------------------|------------------------

 |requestSubmitTime | ge, le, eq, gt, lt
- |provisioningState eq {QuotaRequestState}
- |resourceName eq {resourceName}
+|provisioningState eq {QuotaRequestState}
+|resourceName eq {resourceName}


The markdown table under -Filter is malformed: the rows for provisioningState/resourceName are missing column separators, so it won't render as an actual table and is hard to read. Update the table so each row uses proper | col1 | col2 | formatting.

Copilot · 2026-02-17T04:51:58Z

src/Quota/Quota/help/Update-AzQuota.md

 ### UpdateExpanded (Default)
 ```
-Update-AzQuota -ResourceName <String> -Scope <String> [-Limit <ILimitJsonObject>] [-Name <String>]
+Update-AzQuota -ResourceName <String> -Scope <String> [-Limit <ILimitJsonObject>] [-NameValue <String>]
 [-ResourceType <String>] [-DefaultProfile <PSObject>] [-AsJob] [-NoWait]
 [-WhatIf] [-Confirm] [<CommonParameters>]
 ```


The help content documents an optional parameter as -NameValue, but module/tests/examples in this PR use -Name. This inconsistency will confuse users and may indicate either the docs are stale or the rename directive wasn't applied. Please align the help to the exported cmdlet parameter name (and ensure examples/tests match).

Copilot · 2026-02-17T04:51:58Z

src/Quota/Quota/ChangeLog.md

 ## Upcoming Release
+* Removed cmdlet 'Get-AzQuotaGroupQuotaSubscriptionRequest'
+    - This cmdlet is no longer supported and has been removed from the module
+* API Version Upgrade: Migrated from 2023-02-01 to 2025-09-01 stable


The Upcoming Release notes are missing key user-facing details and issue references. Consider describing the new Group Quota management cmdlets/capabilities in user terms (impact/what users can now do) and linking any relevant GitHub issue(s). Also, for the removed cmdlet, include guidance on what users should use instead (if applicable).

Copilot · 2026-02-17T04:51:58Z

src/Quota/Quota/help/Get-AzQuotaGroupQuotaUsage.md

+Location is required paramater.
+


Typo in synopsis: "paramater" should be "parameter".

Copilot · 2026-02-17T04:51:58Z

src/Quota/Quota/help/Get-AzQuotaOperation.md

@@ -17,7 +17,7 @@ Get-AzQuotaOperation [-DefaultProfile <PSObject>] [<CommonParameters>]
 ```

 ## DESCRIPTION
-List all the operations supported by the Microsoft.Quota resource provider.
+List the operations for the provider



The SYNOPSIS/DESCRIPTION text is overly generic ("List the operations for the provider") and loses the important context that this lists operations supported by the Microsoft.Quota resource provider. Please restore a more specific description so users know what provider and operations this cmdlet targets.

isra-fel · 2026-02-17T05:08:45Z

/azp run

azure-pipelines · 2026-02-17T05:08:59Z

Azure Pipelines successfully started running 3 pipeline(s).

isra-fel · 2026-02-18T15:18:31Z

I think the test cases needs to be recorded again? @RenSilvaAU

isra-fel · 2026-02-25T04:13:53Z

/azp run

azure-pipelines · 2026-02-25T04:14:10Z

Azure Pipelines successfully started running 3 pipeline(s).

isra-fel · 2026-02-25T05:44:05Z

/azp run

azure-pipelines · 2026-02-25T05:44:23Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 110 out of 144 changed files in this pull request and generated 4 comments.

Copilot · 2026-02-25T05:45:25Z

src/Quota/Quota.Autorest/custom/GetAzQuotaGroupQuotaUsage_List.custom.cs

+{
+    using System;
+    using System.Management.Automation;
+    using Microsoft.Azure.PowerShell.Cmdlets.Quota.Runtime.Json;


using Microsoft.Azure.PowerShell.Cmdlets.Quota.Runtime.Json; appears unused in this file, and the repo sets TreatWarningsAsErrors=true (so this can fail the build with an unused-using warning). Remove the unused using or use a referenced type from that namespace.

Suggested change

using Microsoft.Azure.PowerShell.Cmdlets.Quota.Runtime.Json;

Copilot · 2026-02-25T05:45:26Z

...Quota/Quota.Autorest/custom/GetAzQuotaGroupQuotaSubscriptionAllocationRequest_List.custom.cs

+{
+    using System;
+    using System.Management.Automation;
+    using Microsoft.Azure.PowerShell.Cmdlets.Quota.Runtime.Json;


using Microsoft.Azure.PowerShell.Cmdlets.Quota.Runtime.Json; appears unused in this file, and the repo sets TreatWarningsAsErrors=true (so this can fail the build with an unused-using warning). Remove the unused using or use a referenced type from that namespace.

Suggested change

using Microsoft.Azure.PowerShell.Cmdlets.Quota.Runtime.Json;

Copilot · 2026-02-25T05:45:26Z

src/Quota/Quota/help/New-AzQuotaGroupQuotaSubscription.md

+### Example 1: Add a subscription to a GroupQuota
+```powershell
+New-AzQuotaGroupQuotaSubscription -ManagementGroupId "admintest"  -GroupQuotaName "groupquota1" -SubscriptionId "{subId}"
+```
+
+```output
+New-AzQuotaGroupQuotaSubscription_Create: The subscription {subId} is already registered for a Quota Group, please select another subscription and try again.
+```
+
+Add a subscription to an existing GroupQuota.
+Note: If the subscription is already registered, an error will be returned.


The example output here is an error message ("already registered for a Quota Group"), which makes the example look like the cmdlet fails by default. Prefer a successful example (or clearly label this as an example of handling the 'already registered' error and include a success-path example as well).

Copilot · 2026-02-25T05:45:26Z

src/Quota/Quota.sln

@@ -19,7 +19,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Authenticators", "..\Accoun
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Quota", "Quota\Quota.csproj", "{699E40C9-43A1-4F36-8DA5-4CBD28DB4A58}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.Quota", "..\..\generated\Quota\Quota.Autorest\Az.Quota.csproj", "{1FFEAE1C-DF2A-4DFD-A425-CB31B99B3BD7}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.Quota", "Quota.Autorest\Az.Quota.csproj", "{7CF61438-1417-4131-B3D9-ADCC804CB1DA}"
 EndProject


The solution file now begins with a blank first line and references Quota.Autorest\Az.Quota.csproj, but there is no Az.Quota.csproj under src/Quota/Quota.Autorest. This will likely prevent Visual Studio/MSBuild from loading/building the solution. Restore the standard first line (with optional BOM) and point Az.Quota back to the existing project path (e.g., under generated/Quota/Quota.Autorest) or add the missing csproj at the referenced location.

isra-fel · 2026-02-25T08:11:52Z

/azp run

azure-pipelines · 2026-02-25T08:12:09Z

Azure Pipelines successfully started running 3 pipeline(s).

comment addressed

…table (#28902) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Yash <55773468+notyashhh@users.noreply.github.com> Co-authored-by: Yeming Liu <11371776+isra-fel@users.noreply.github.com>

RenSilvaAU and others added 18 commits November 11, 2025 11:41

upgraded devcontainer

16c574a

updated group quota version

7e360ff

ran autorest for quota

2dabe68

updated and ran quota tests - created initial group quota tests

569fde2

Merge branch 'Azure:main' into resilv/group-quota-sept

ffd8044

Merge branch 'Azure:main' into resilv/group-quota-sept

88c3559

adding quota tests

665b705

added more quota tests

1346d40

further tests in quota

382951e

quota tests passed

69412e9

all quota tests passed

3d641a6

all quota tests passed - 2nd time

a25bae5

updated examples

afc588e

Merge branch 'Azure:main' into resilv/group-quota-sept

74b033a

built examples quota

4af7708

quota examples tested

9e421f7

Merge branch 'Azure:main' into resilv/group-quota-sept

ba17659

Merge branch 'Azure:main' into resilv/group-quota-sept

8225e7a

RenSilvaAU added 2 commits November 19, 2025 18:52

reran all quota tests. 2 failed

10c3c6a

Merge branch 'resilv/group-quota-sept' of https://github.com/RenSilva…

4b3180a

…AU/azure-powershell into resilv/group-quota-sept

RenSilvaAU self-assigned this Nov 19, 2025

RenSilvaAU requested a review from dolauli November 19, 2025 22:32

RenSilvaAU added 3 commits November 20, 2025 15:04

all tests in qutoa addressed

e866318

addressed remaining quota tests - only one problem remains

5f07bb4

reran all quota tests - one still failing

201d50a

notyashhh previously requested changes Nov 21, 2025

View reviewed changes

Merge branch 'Azure:main' into resilv/group-quota-sept

46c8a90

Copilot AI reviewed Feb 17, 2026

View reviewed changes

RenSilvaAU added 2 commits February 17, 2026 15:42

reverted test.env

a3f3555

reverted Assembly info

d16620d

Copilot AI review requested due to automatic review settings February 17, 2026 04:44

Copilot started reviewing on behalf of RenSilvaAU February 17, 2026 04:47 View session

Copilot AI reviewed Feb 17, 2026

View reviewed changes

Merge branch 'Azure:main' into resilv/group-quota-sept

72e4815

Fix line endings in dev container post-create script for Linux

b1cf4be

Copilot AI review requested due to automatic review settings February 25, 2026 05:36

Copilot started reviewing on behalf of RenSilvaAU February 25, 2026 05:39 View session

Copilot AI reviewed Feb 25, 2026

View reviewed changes

retested quota

d65927b

isra-fel enabled auto-merge (squash) February 25, 2026 13:45

isra-fel approved these changes Feb 25, 2026

View reviewed changes

isra-fel merged commit c3bd89f into Azure:main Feb 25, 2026
12 checks passed

		Gets the GroupQuotas usages and limits(quota).
		Location is required paramter.

Conversation

RenSilvaAU commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Key Changes:

Changes:

Mandatory Checklist

Uh oh!

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

Uh oh!

notyashhh commented Nov 20, 2025

Uh oh!

azure-pipelines bot commented Nov 20, 2025

Uh oh!

notyashhh left a comment

Choose a reason for hiding this comment

Uh oh!

RenSilvaAU commented Feb 17, 2026

Uh oh!

isra-fel commented Feb 17, 2026

Uh oh!

azure-pipelines bot commented Feb 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

isra-fel commented Feb 17, 2026

Uh oh!

azure-pipelines bot commented Feb 17, 2026

Uh oh!

isra-fel commented Feb 18, 2026

Uh oh!

isra-fel commented Feb 25, 2026

Uh oh!

azure-pipelines bot commented Feb 25, 2026

Uh oh!

isra-fel commented Feb 25, 2026

Uh oh!

azure-pipelines bot commented Feb 25, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 25, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 25, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 25, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 25, 2026

RenSilvaAU commented Nov 19, 2025 •

edited

Loading