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

isra-fel · 2026-01-27T02:09:12Z

/azp run

azure-pipelines · 2026-01-27T02:09:30Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

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

Comments suppressed due to low confidence (6)

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

This appears to commit real Tenant/Subscription GUIDs into the repository. Even if not secrets, these identifiers can be sensitive and can unintentionally couple tests/recordings to a specific environment. Prefer using placeholder values (e.g., '00000000-0000-0000-0000-000000000000') and rely on loadEnv.ps1 / CI secret variables to inject real IDs at runtime, or ensure the test framework’s sanitization replaces them during recording generation.
src/Quota/Quota.Autorest/test/Update-AzQuota.Tests.ps1:1
The generated help/docs in this PR show Update-AzQuota uses -NameValue (not -Name). These tests still call -Name, which is likely to fail parameter binding unless an alias exists. Update the tests to use -NameValue (or remove the parameter if it’s optional and not required by the cmdlet).
src/Quota/Quota.Autorest/test/Update-AzQuota.Tests.ps1:1
The generated help/docs in this PR show Update-AzQuota uses -NameValue (not -Name). These tests still call -Name, which is likely to fail parameter binding unless an alias exists. Update the tests to use -NameValue (or remove the parameter if it’s optional and not required by the cmdlet).
src/Quota/Quota.Autorest/test/Get-AzQuotaGroupQuotaSubscriptionAllocationRequest.Tests.ps1:1
This test will always pass, even if the cmdlet throws or returns unexpected output. To keep recordings robust while still validating behavior, assert something concrete (e.g., that the call does not throw, or that the returned object has expected shape when present). If known service/cmdlet bugs require soft-fail, prefer Set-ItResult -Skipped with a specific reason or assert on the expected exception/message.
src/Quota/Quota/help/Get-AzQuotaGroupQuotaUsage.md:1
Corrected spelling of 'paramter' to 'parameter'.
src/Quota/Quota/help/Az.Quota.md:1
Corrected spelling of 'Ten' to 'Then' in this sentence.

Copilot · 2026-01-27T02:20:28Z

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

+
+            // Check if response is plain text (not JSON)
+            if (!string.IsNullOrEmpty(content) && !content.TrimStart().StartsWith("{") && !content.TrimStart().StartsWith("["))
+            {
+                // Handle plain text response
+                if (content.Trim() == "[]")
+                {
+                    // Empty array - output nothing (no allocation requests found)
+                    returnNow = global::System.Threading.Tasks.Task.FromResult(true);
+                }
+                else


Same logic issue as the other custom override: the [] handling can’t be reached due to the !StartsWith(\"[\") guard. Reorder the checks (handle [] first) or use Content-Type to decide whether to treat the payload as JSON vs plain text.

Suggested change

// Check if response is plain text (not JSON)

if (!string.IsNullOrEmpty(content) && !content.TrimStart().StartsWith("{") && !content.TrimStart().StartsWith("["))

{

// Handle plain text response

if (content.Trim() == "[]")

{

// Empty array - output nothing (no allocation requests found)

returnNow = global::System.Threading.Tasks.Task.FromResult(true);

}

else

if (!string.IsNullOrEmpty(content))

{

var trimmedContent = content.Trim();

// Handle empty array response explicitly

if (trimmedContent == "[]")

{

// Empty array - output nothing (no allocation requests found)

returnNow = global::System.Threading.Tasks.Task.FromResult(true);

}

// Check if response is plain text (not JSON)

else if (!trimmedContent.StartsWith("{") && !trimmedContent.StartsWith("["))

Copilot

Copilot wasn't able to review any files in this pull request.

isra-fel · 2026-01-27T03:39:37Z

/azp run

azure-pipelines · 2026-01-27T03:39:56Z

Azure Pipelines successfully started running 3 pipeline(s).

isra-fel · 2026-01-27T05:39:07Z

/azp run

azure-pipelines · 2026-01-27T05:39:22Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Copilot wasn't able to review any files in this pull request.

isra-fel · 2026-01-27T23:38:38Z

/azp run

azure-pipelines · 2026-01-27T23:38:53Z

Azure Pipelines successfully started running 3 pipeline(s).

isra-fel · 2026-01-28T00:08:57Z

/azp run

azure-pipelines · 2026-01-28T00:09:14Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Copilot wasn't able to review any files in this pull request.

isra-fel · 2026-01-28T02:08:36Z

/azp run

azure-pipelines · 2026-01-28T02:08:51Z

Azure Pipelines successfully started running 3 pipeline(s).

RenSilvaAU · 2026-01-28T02:32:02Z

@dolauli , @isra-fel , @notyashhh

Comments have been addressed and tests now pass in Playback mode.

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 requested changes Nov 21, 2025

View reviewed changes

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

46c8a90

Copilot AI reviewed Jan 27, 2026

View reviewed changes

RenSilvaAU added 2 commits January 27, 2026 14:34

rerecorded Quota tests

1c7b91d

updated readme for Quota, removing manual version update

56de1ac

Copilot AI review requested due to automatic review settings January 27, 2026 03:38

Copilot AI reviewed Jan 27, 2026

View reviewed changes

temporarily removed tests recordings for quota

d0094ef

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

f71fb60

Copilot AI review requested due to automatic review settings January 27, 2026 23:28

Copilot AI reviewed Jan 27, 2026

View reviewed changes

rerecorded Quota tests

d6f7664

reworked Quota tests with non-random keys

d503667

Copilot AI review requested due to automatic review settings January 28, 2026 01:40

Copilot AI reviewed Jan 28, 2026

View reviewed changes

isra-fel assigned isra-fel and unassigned RenSilvaAU Jan 28, 2026

isra-fel added the needs-review label Jan 28, 2026

isra-fel added this to the Az 15.4.0 (03/03/2026) milestone Jan 28, 2026

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!

isra-fel commented Jan 27, 2026

Uh oh!

azure-pipelines bot commented Jan 27, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Jan 27, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

isra-fel commented Jan 27, 2026

Uh oh!

azure-pipelines bot commented Jan 27, 2026

Uh oh!

isra-fel commented Jan 27, 2026

Uh oh!

azure-pipelines bot commented Jan 27, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

isra-fel commented Jan 27, 2026

Uh oh!

azure-pipelines bot commented Jan 27, 2026

Uh oh!

isra-fel commented Jan 28, 2026

Uh oh!

azure-pipelines bot commented Jan 28, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

isra-fel commented Jan 28, 2026

Uh oh!

azure-pipelines bot commented Jan 28, 2026

Uh oh!

RenSilvaAU commented Jan 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

RenSilvaAU commented Nov 19, 2025 •

edited

Loading