Skip to content

[AutoPR @azure-arm-managementgroups]-generated-from-SDK Generation - JS-6345731#38654

Merged
JialinHuang803 merged 3 commits into
mainfrom
sdkauto/@azure-arm-managementgroups-6345731
May 26, 2026
Merged

[AutoPR @azure-arm-managementgroups]-generated-from-SDK Generation - JS-6345731#38654
JialinHuang803 merged 3 commits into
mainfrom
sdkauto/@azure-arm-managementgroups-6345731

Conversation

@azure-sdk
Copy link
Copy Markdown
Collaborator

Configurations: 'specification/management/resource-manager/Microsoft.Management/ManagementGroups/tspconfig.yaml', API Version: 2023-04-01, SDK Release Type: beta, and CommitSHA: '7803170d3e2e8d25cc67ac1d27ad50aa7e24d3a0' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=6345731 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release.

…Management/ManagementGroups/tspconfig.yaml', API Version: 2023-04-01, SDK Release Type: beta, and CommitSHA: '7803170d3e2e8d25cc67ac1d27ad50aa7e24d3a0' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=6345731 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release.
@github-actions github-actions Bot added the Mgmt This issue is related to a management-plane library. label May 25, 2026
@v-jiaodi v-jiaodi marked this pull request as ready for review May 25, 2026 07:26
Copilot AI review requested due to automatic review settings May 25, 2026 07:26
@v-jiaodi v-jiaodi added refresh PR for SDK refresh mgmt-review-needed labels May 25, 2026
@github-actions github-actions Bot added mgmt-review-in-progress Management SDK review is in progress and removed mgmt-review-needed labels May 25, 2026
@github-actions
Copy link
Copy Markdown
Contributor

Next Steps to Merge

Only failed checks and required actions are listed below.

  • ⏳ js - pullrequest (Build Build): still running. Review ADO logs.
  • ⏳ js - pullrequest (Build Analyze): still running. Review ADO logs.
  • ⏳ js - pullrequest: queued, waiting for sub-checks to complete. Review ADO logs.

@github-actions github-actions Bot added mgmt-review-added Management SDK review completed and removed mgmt-review-in-progress Management SDK review is in progress labels May 25, 2026
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

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

No API design issues found. The public API surface for @azure/arm-managementgroups@3.0.0-beta.1 (API version 2023-04-01) looks clean: version strings are consistent across package.json, the context file, and CHANGELOG.md; no naming anti-patterns (_N, AutoGenerated, _ prefixes) were detected; type safety rules are respected; and all public symbols are properly exported.

📊 Structured Report
{"agent":"mgmt-reviewer","pr":38654,"summary":"clean","findings":[]}

Benchmarked by Management Release Assistant

Copy link
Copy Markdown
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 is an auto-generated update for @azure/arm-managementgroups from the Management Groups TypeSpec configuration (2023-04-01) targeting a beta release. It refreshes the package to the newer REST/“classic” layered structure, updates build/test configuration, and regenerates samples and API reports to match the new surface.

Changes:

  • Regenerated the @azure/arm-managementgroups client and API surface for 2023-04-01 (beta), including new api/* + classic/* structure and helper utilities.
  • Updated build configuration (Warp exports/targets, tsconfig references) and CI trigger filtering.
  • Refreshed samples (added v3-beta, removed older v2) and updated changelog/assets metadata.

Reviewed changes

Copilot reviewed 187 out of 189 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
sdk/managementgroups/ci.mgmt.yml Updates CI trigger branch filters for managementgroups.
sdk/managementgroups/arm-managementgroups/warp.config.yml Moves to explicit Warp exports + targets configuration for the package build.
sdk/managementgroups/arm-managementgroups/tsp-location.yaml Adds TypeSpec source location metadata for reproducible generation.
sdk/managementgroups/arm-managementgroups/tsconfig.json Updates project references (adds browser test tsconfig, adjusts ordering).
sdk/managementgroups/arm-managementgroups/test/snippets.spec.ts Updates snippet sources to match the new ManagementGroupsAPI constructor shape.
sdk/managementgroups/arm-managementgroups/src/static-helpers/simplePollerHelpers.ts Adds compatibility helper to adapt PollerLike to a simpler/deprecated poller interface.
sdk/managementgroups/arm-managementgroups/src/static-helpers/serialization/check-prop-undefined.ts Adds serialization helper to detect “all undefined” property sets.
sdk/managementgroups/arm-managementgroups/src/static-helpers/pollingHelpers.ts Adds LRO polling helpers built on @azure/core-lro + REST client responses.
sdk/managementgroups/arm-managementgroups/src/static-helpers/cloudSettingHelpers.ts Adds Azure cloud selection and ARM endpoint resolution helper.
sdk/managementgroups/arm-managementgroups/src/pagingHelper.ts Removes legacy paging helper used by previous generator output.
sdk/managementgroups/arm-managementgroups/src/operationsInterfaces/operations.ts Removes legacy operation interface file in favor of new structure.
sdk/managementgroups/arm-managementgroups/src/operationsInterfaces/managementGroupSubscriptions.ts Removes legacy operation interface file in favor of new structure.
sdk/managementgroups/arm-managementgroups/src/operationsInterfaces/managementGroups.ts Removes legacy operation interface file in favor of new structure.
sdk/managementgroups/arm-managementgroups/src/operationsInterfaces/index.ts Removes legacy operation interface barrel file.
sdk/managementgroups/arm-managementgroups/src/operationsInterfaces/hierarchySettingsOperations.ts Removes legacy operation interface file in favor of new structure.
sdk/managementgroups/arm-managementgroups/src/operationsInterfaces/entities.ts Removes legacy operation interface file in favor of new structure.
sdk/managementgroups/arm-managementgroups/src/operations/operations.ts Removes legacy generated operation implementation in favor of new REST-based implementation.
sdk/managementgroups/arm-managementgroups/src/operations/index.ts Removes legacy operations barrel file.
sdk/managementgroups/arm-managementgroups/src/operations/entities.ts Removes legacy generated operation implementation in favor of new REST-based implementation.
sdk/managementgroups/arm-managementgroups/src/lroImpl.ts Removes legacy LRO implementation in favor of new LRO helpers.
sdk/managementgroups/arm-managementgroups/src/logger.ts Adds client logger wiring for the regenerated package.
sdk/managementgroups/arm-managementgroups/src/index.ts Updates public entrypoint exports to match regenerated API surface and helpers.
sdk/managementgroups/arm-managementgroups/src/classic/operations/index.ts Adds “classic” operation-group wrapper for operations.
sdk/managementgroups/arm-managementgroups/src/classic/managementGroupSubscriptions/index.ts Adds “classic” operation-group wrapper for managementGroupSubscriptions.
sdk/managementgroups/arm-managementgroups/src/classic/index.ts Adds “classic” operation-group type exports.
sdk/managementgroups/arm-managementgroups/src/classic/hierarchySettings/index.ts Adds “classic” operation-group wrapper for hierarchySettings.
sdk/managementgroups/arm-managementgroups/src/classic/entities/index.ts Adds “classic” operation-group wrapper for entities.
sdk/managementgroups/arm-managementgroups/src/api/options.ts Adds top-level operation option types extending OperationOptions.
sdk/managementgroups/arm-managementgroups/src/api/operations/options.ts Adds option type for listing operations.
sdk/managementgroups/arm-managementgroups/src/api/operations/operations.ts Adds REST-layer implementation for listing operations + paging iterator wiring.
sdk/managementgroups/arm-managementgroups/src/api/operations/index.ts Adds REST-layer barrel for operations.
sdk/managementgroups/arm-managementgroups/src/api/operations.ts Adds REST-layer implementations for tenant backfill and name availability operations.
sdk/managementgroups/arm-managementgroups/src/api/managementGroupSubscriptions/options.ts Adds REST-layer option types for managementGroupSubscriptions operations.
sdk/managementgroups/arm-managementgroups/src/api/managementGroupSubscriptions/index.ts Adds REST-layer barrel for managementGroupSubscriptions.
sdk/managementgroups/arm-managementgroups/src/api/managementGroupsAPIContext.ts Adds REST client context factory + options (apiVersion/cloud/userAgent/logging).
sdk/managementgroups/arm-managementgroups/src/api/managementGroups/options.ts Adds REST-layer option types for managementGroups operations (including LRO intervals).
sdk/managementgroups/arm-managementgroups/src/api/managementGroups/index.ts Adds REST-layer barrel for managementGroups.
sdk/managementgroups/arm-managementgroups/src/api/index.ts Adds REST-layer barrel + context creator export.
sdk/managementgroups/arm-managementgroups/src/api/hierarchySettings/options.ts Adds REST-layer option types for hierarchySettings operations.
sdk/managementgroups/arm-managementgroups/src/api/hierarchySettings/index.ts Adds REST-layer barrel for hierarchySettings.
sdk/managementgroups/arm-managementgroups/src/api/entities/options.ts Adds REST-layer option types for entity listing (query params + cache header).
sdk/managementgroups/arm-managementgroups/src/api/entities/operations.ts Adds REST-layer entity listing + paging iterator wiring.
sdk/managementgroups/arm-managementgroups/src/api/entities/index.ts Adds REST-layer barrel for entities.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/tsconfig.json Updates TS sample compilation settings to modern NodeNext/ES2023 settings.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/tenantBackfillStatusSample.ts Adds regenerated beta TypeScript sample for tenant backfill status.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/startTenantBackfillSample.ts Adds regenerated beta TypeScript sample for starting tenant backfill.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/operationsListSample.ts Adds regenerated beta TypeScript sample for listing operations.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupsUpdateSample.ts Adds regenerated beta TypeScript sample for updating management groups.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupSubscriptionsListSubscriptionsUnderManagementGroupSample.ts Adds regenerated beta TypeScript sample for listing mgmt-group subscriptions.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupSubscriptionsGetSubscriptionSample.ts Adds regenerated beta TypeScript sample for getting a subscription under a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupSubscriptionsDeleteSample.ts Adds regenerated beta TypeScript sample for removing a subscription from a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupSubscriptionsCreateSample.ts Adds regenerated beta TypeScript sample for adding a subscription to a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupsListSample.ts Adds regenerated beta TypeScript sample for listing management groups.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupsListDescendantsSample.ts Adds regenerated beta TypeScript sample for listing descendants.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupsGetSample.ts Adds regenerated beta TypeScript sample for various get patterns.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupsDeleteSample.ts Adds regenerated beta TypeScript sample for deleting a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/managementGroupsCreateOrUpdateSample.ts Adds regenerated beta TypeScript sample for createOrUpdate.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/hierarchySettingsUpdateSample.ts Adds regenerated beta TypeScript sample for hierarchy settings update.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/hierarchySettingsListSample.ts Adds regenerated beta TypeScript sample for hierarchy settings list.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/hierarchySettingsGetSample.ts Adds regenerated beta TypeScript sample for hierarchy settings get.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/hierarchySettingsDeleteSample.ts Adds regenerated beta TypeScript sample for hierarchy settings delete.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/hierarchySettingsCreateOrUpdateSample.ts Adds regenerated beta TypeScript sample for hierarchy settings createOrUpdate.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/entitiesListSample.ts Adds regenerated beta TypeScript sample for entity listing.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/src/checkNameAvailabilitySample.ts Adds regenerated beta TypeScript sample for name availability checks.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/sample.env Regenerates beta TypeScript sample env placeholder.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/typescript/package.json Updates beta TypeScript sample package metadata/deps.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/tenantBackfillStatusSample.js Adds regenerated beta JavaScript sample for tenant backfill status.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/startTenantBackfillSample.js Adds regenerated beta JavaScript sample for starting tenant backfill.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/sample.env Regenerates beta JavaScript sample env placeholder.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/package.json Updates beta JavaScript sample package metadata/deps.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/operationsListSample.js Adds regenerated beta JavaScript sample for listing operations.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupsUpdateSample.js Adds regenerated beta JavaScript sample for updating management groups.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupSubscriptionsListSubscriptionsUnderManagementGroupSample.js Adds regenerated beta JavaScript sample for listing mgmt-group subscriptions.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupSubscriptionsGetSubscriptionSample.js Adds regenerated beta JavaScript sample for getting a subscription under a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupSubscriptionsDeleteSample.js Adds regenerated beta JavaScript sample for removing a subscription from a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupSubscriptionsCreateSample.js Adds regenerated beta JavaScript sample for adding a subscription to a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupsListSample.js Adds regenerated beta JavaScript sample for listing management groups.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupsListDescendantsSample.js Adds regenerated beta JavaScript sample for listing descendants.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupsGetSample.js Adds regenerated beta JavaScript sample for various get patterns.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupsDeleteSample.js Adds regenerated beta JavaScript sample for deleting a management group.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/managementGroupsCreateOrUpdateSample.js Adds regenerated beta JavaScript sample for createOrUpdate.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/hierarchySettingsUpdateSample.js Adds regenerated beta JavaScript sample for hierarchy settings update.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/hierarchySettingsListSample.js Adds regenerated beta JavaScript sample for hierarchy settings list.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/hierarchySettingsGetSample.js Adds regenerated beta JavaScript sample for hierarchy settings get.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/hierarchySettingsDeleteSample.js Adds regenerated beta JavaScript sample for hierarchy settings delete.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/hierarchySettingsCreateOrUpdateSample.js Adds regenerated beta JavaScript sample for hierarchy settings createOrUpdate.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/entitiesListSample.js Adds regenerated beta JavaScript sample for entity listing.
sdk/managementgroups/arm-managementgroups/samples/v3-beta/javascript/checkNameAvailabilitySample.js Adds regenerated beta JavaScript sample for name availability checks.
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/tenantBackfillStatusSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/startTenantBackfillSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/operationsListSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupsUpdateSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupSubscriptionsGetSubscriptionsUnderManagementGroupSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupSubscriptionsGetSubscriptionSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupSubscriptionsDeleteSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupSubscriptionsCreateSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupsListSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupsGetSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupsGetDescendantsSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupsDeleteSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/managementGroupsCreateOrUpdateSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/hierarchySettingsUpdateSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/hierarchySettingsListSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/hierarchySettingsGetSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/hierarchySettingsDeleteSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/hierarchySettingsCreateOrUpdateSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/entitiesListSample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/src/checkNameAvailabilitySample.ts Removes legacy v2 TypeScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/typescript/sample.env Removes legacy v2 TypeScript sample env placeholders.
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/tenantBackfillStatusSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/startTenantBackfillSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/sample.env Removes legacy v2 JavaScript sample env placeholders.
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/operationsListSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupsUpdateSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupSubscriptionsGetSubscriptionsUnderManagementGroupSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupSubscriptionsGetSubscriptionSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupSubscriptionsDeleteSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupSubscriptionsCreateSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupsListSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupsGetSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupsGetDescendantsSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupsDeleteSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/managementGroupsCreateOrUpdateSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/hierarchySettingsUpdateSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/hierarchySettingsListSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/hierarchySettingsGetSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/hierarchySettingsDeleteSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/hierarchySettingsCreateOrUpdateSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/entitiesListSample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples/v2/javascript/checkNameAvailabilitySample.js Removes legacy v2 JavaScript sample file(s).
sdk/managementgroups/arm-managementgroups/samples-dev/tenantBackfillStatusSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/startTenantBackfillSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/operationsListSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupsUpdateSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupSubscriptionsListSubscriptionsUnderManagementGroupSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupSubscriptionsGetSubscriptionSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupSubscriptionsDeleteSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupSubscriptionsCreateSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupsListSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupsListDescendantsSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupsDeleteSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/managementGroupsCreateOrUpdateSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/hierarchySettingsUpdateSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/hierarchySettingsListSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/hierarchySettingsGetSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/hierarchySettingsDeleteSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/hierarchySettingsCreateOrUpdateSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/entitiesListSample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/samples-dev/checkNameAvailabilitySample.ts Updates sample-dev source to current API + modern main() pattern.
sdk/managementgroups/arm-managementgroups/sample.env Updates root sample.env placeholder content.
sdk/managementgroups/arm-managementgroups/review/arm-managementgroups-browser.api.diff.md Updates browser-vs-node API diff (e.g., DOM name collisions like Permissions).
sdk/managementgroups/arm-managementgroups/LICENSE Normalizes license file formatting/EOF newline.
sdk/managementgroups/arm-managementgroups/eslint.config.mjs Minor formatting adjustment to ESLint config.
sdk/managementgroups/arm-managementgroups/config/tsconfig.test.node.json Adds path mappings for tests to resolve local source package imports.
sdk/managementgroups/arm-managementgroups/config/tsconfig.test.browser.json Adds browser test tsconfig with local path mappings.
sdk/managementgroups/arm-managementgroups/config/tsconfig.src.esm.json Formatting/normalization of includes.
sdk/managementgroups/arm-managementgroups/config/tsconfig.src.cjs.json Formatting/normalization of includes.
sdk/managementgroups/arm-managementgroups/config/tsconfig.src.browser.json Formatting/normalization of includes.
sdk/managementgroups/arm-managementgroups/config/tsconfig.samples.json Normalizes samples tsconfig path mapping formatting.
sdk/managementgroups/arm-managementgroups/CHANGELOG.md Updates release history for 3.0.0-beta.1 and documents breaking changes.
sdk/managementgroups/arm-managementgroups/assets.json Updates assets tag for recordings/assets sync.
sdk/managementgroups/arm-managementgroups/api-extractor.json Normalizes api-extractor JSON formatting.
sdk/managementgroups/arm-managementgroups/_meta.json Removes legacy AutoRest _meta.json metadata (replaced by TypeSpec metadata).
pnpm-lock.yaml Updates lockfile importer entries for the regenerated package dependencies/tooling.
.github/CODEOWNERS Adjusts labels/ownership metadata for arm-managementgroups path.
Files not reviewed (1)
  • pnpm-lock.yaml: Language not supported

Comment thread sdk/managementgroups/arm-managementgroups/src/index.ts
@JialinHuang803
Copy link
Copy Markdown
Member

JialinHuang803 commented May 25, 2026

Note

This analysis was generated by AI. Please review the classifications and root causes for accuracy.

Breaking Change Analysis: @azure/arm-managementgroups 3.0.0-beta.1

Old SDK (main) New SDK (PR)
Generator Swagger / AutoRest TypeSpec / emitter
API Version 2021-04-01 2023-04-01
Package Version 2.0.2 3.0.0-beta.1

Spec References:


Type 1: API Version Upgrade (2021-04-01 -> 2023-04-01) -- 10 items

# Breaking Change Root Cause
1 Removed Type Alias Enum0 2021-04-01 expand param had no x-ms-enum; AutoRest generated generic name. 2023-04-01 properly names it ManagementGroupExpandType.
2 Removed Type Alias Enum2 Same as row 1: search param now properly named EntitySearchType in 2023-04-01.
3 Removed Type Alias Enum3 Same as row 1: view param now properly named EntityViewParameterType in 2023-04-01.
4 Removed Enum KnownEnum0 Associated Known enum for Enum0; replaced by KnownManagementGroupExpandType.
5 Removed Enum KnownEnum2 Same as row 4: replaced by KnownEntitySearchType.
6 Removed Enum KnownEnum3 Same as row 4: replaced by KnownEntityViewParameterType.
7 Type alias "ManagementGroupChildType" has been changed 2021-04-01 had no x-ms-enum (AutoRest generated extensible string + KnownXxx). 2023-04-01 has modelAsString: false making it a fixed enum rendered as inline union "Microsoft.Management/managementGroups" | "/subscriptions".
8 Removed Enum KnownManagementGroupChildType Same as row 7: modelAsString: false means fixed enum; no extensible Known enum generated.
9 Removed Enum KnownPermissions Same as row 7: 2023-04-01 Permissions has modelAsString: false; rendered as fixed inline union.
10 Removed Type Alias Permissions_2 Same as row 9: old SDK generated both Permissions (string alias) and KnownPermissions (enum). Now a single fixed union type.

Type 2: TypeSpec / Emitter Migration -- 10 items

Root Cause Sub-Type Count Accepted
TypeSpec uses ARM common error types (ErrorDetail) instead of service-defined ErrorDetails Conversion 2
Orphan model removed (not referenced by any operation in TypeSpec) Conversion 3
Paging collection wrapper type internalized; emitter returns PagedAsyncIterableIterator directly Emitter 1
LRO response model not exposed; emitter returns void for delete operations Emitter 1
Options interface verb renamed (GetDescendants -> ListDescendants) due to emitter paging convention Emitter 2
beginDeleteAndWait signature changed: return type void + resumeFrom removed (new LRO pattern uses restorePoller) Emitter 1

Details

  1. Removed Interface ErrorDetails -- Conversion ✅

    TypeSpec uses ARM common error type reference (common-types/v3/ErrorResponse). Layer B has ErrorDetails; Layer C references ARM common ErrorDetail instead.

  2. Type of parameter error of interface ErrorResponse is changed from ErrorDetails to ErrorDetail -- Conversion ✅

    Cascading from row 1: ErrorResponse.error property type changed because TypeSpec uses ARM common ErrorDetail.

  3. Removed Interface EntityHierarchyItem -- Conversion ✅

    Model exists in Layer B swagger but removed in TypeSpec (Layer C). Not referenced by any operation -- orphan model pruned by TypeSpec tree-shaking.

  4. Removed Interface OperationDisplayProperties -- Conversion ✅

    Layer B has OperationDisplayProperties; TypeSpec uses ARM common Operation type with OperationDisplay sub-model. Orphan model not referenced by operations.

  5. Removed Interface OperationResults -- Conversion ✅

    Model exists in Layer B but removed in TypeSpec (Layer C). Not referenced by any operation signature -- orphan model.

  6. Removed Interface AzureAsyncOperationResults -- Emitter ✅

    Model exists in both Layer B and Layer C (delete 202 response). However, emitter treats ARM delete LRO as returning void per standard ARM patterns, so this response model is not exposed in the SDK.

  7. Removed Interface ListSubscriptionUnderManagementGroup -- Emitter ✅

    Collection wrapper type exists in both Layer B and Layer C. Emitter internalizes paging wrappers and returns PagedAsyncIterableIterator<SubscriptionUnderManagementGroup> directly.

  8. Removed Interface ManagementGroupsGetDescendantsOptionalParams -- Emitter

    Swagger operationId is ManagementGroups_GetDescendants in all layers. AutoRest used operationId for options naming; TypeSpec emitter uses the SDK method name (listDescendants) -- resulting in ManagementGroupsListDescendantsOptionalParams.

  9. Removed Interface ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupOptionalParams -- Emitter

    Same as row 8: emitter renames options to match SDK method name. Replaced by ManagementGroupSubscriptionsListSubscriptionsUnderManagementGroupOptionalParams.

  10. Operation ManagementGroups.beginDeleteAndWait has a new signature -- Emitter

    Two independent causes: (1) Return type changed from AzureAsyncOperationResults to void -- cascading from row 6 (emitter ARM delete LRO pattern). (2) resumeFrom removed from LRO options -- emitter uses restorePoller utility for LRO resumption instead of inline option.


Total: 10 (Type 1: API Version Upgrade) + 10 (Type 2: TypeSpec/Emitter Migration) = 20 breaking changes

Type 2 breakdown: 5 items from TypeSpec conversion, 5 items from emitter differences.


Methodology

Four-layer comparison model:

  • Layer A (old swagger 2021-04-01 @ 184b23b6): Base for old SDK
  • Layer B (original 2023-04-01 swagger @ b0ee8fff): Hand-written swagger before TypeSpec conversion (base of spec PR #38384)
  • Layer C (TypeSpec-generated 2023-04-01 @ 09f28748): Generated swagger from TypeSpec
  • Layer D (SDK api.md): Old vs new arm-managementgroups-node.api.md

Classification: Layer A != B -> Type 1; Layer B != C -> Type 2a (Conversion); Layer B == C but D differs -> Type 2b (Emitter).

…Management/ManagementGroups/tspconfig.yaml', API Version: 2023-04-01, SDK Release Type: beta, and CommitSHA: '09f28748225dfa888ed244701dc762aaf13efb41' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=6350147 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release.
@JialinHuang803 JialinHuang803 merged commit 29f9901 into main May 26, 2026
13 checks passed
@JialinHuang803 JialinHuang803 deleted the sdkauto/@azure-arm-managementgroups-6345731 branch May 26, 2026 09:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Mgmt This issue is related to a management-plane library. mgmt-review-added Management SDK review completed refresh PR for SDK refresh

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants