Migrate resource manager resources generation to TypeSpec by weidongxu-microsoft · Pull Request #50111 · Azure/azure-sdk-for-java

Weidong Xu (weidongxu-microsoft) · 2026-08-12T12:26:08Z

Summary

Migrate the combined Resource Manager resources library from Swagger generation to the selected TypeSpec projects.
Preserve the existing public API and handwritten integration through TypeSpec and Java customizations.
Prevent SDK automation from deleting outputs belonging to other projects in the combined package.
Update playback assets and reviewed RevAPI suppressions.

Testing

mvn -f sdk/resources/azure-resourcemanager-resources/pom.xml test
- 91 tests run, 0 failures, 0 errors, 7 skipped.
RevAPI comparison against 2.54.2 completes without API compatibility failures.

Regenerate the features, locks, and changes Swagger projects while removing generated code owned by projects migrating to TypeSpec. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Remove generated policy samples that are no longer owned by the retained Swagger projects. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Replace the AutoRest deletion marker in files owned by the retained Swagger projects so TypeSpec regeneration does not remove them. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add the data boundaries TypeSpec checkpoint, scoped metadata, and ResourceManager-based generated samples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Record the data boundaries checkpoint and reusable workflow for the remaining multi-source generation steps. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add the deployment stacks TypeSpec-generated client at API version 2024-03-01 and preserve the legacy ActionOnUnmanage enum signatures. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Regenerate deployment stacks with the legacy Java properties flattening used by the original Swagger client. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Generate the policy client at API version 2026-07-01 and preserve the legacy policy exemption client and models for compatibility. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add an AST customization limited to PolicyClient and PolicyClientImpl so the preserved policy exemption client remains accessible. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Target the generated PolicyClient interface declaration and emit a marker Override annotation on its implementation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Apply the Java AST customization to expose the preserved PolicyExemptionsClient through PolicyClient and PolicyClientImpl. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add policy samples for the TypeSpec-generated 2026-07-01 surface while retaining earlier project samples and excluding stale generated tests. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Generate the subscription client into the combined resources package while preserving the original client grouping and API version. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Use the package-specific subscription client accessor from the shared ResourceManager entry point. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Keep ResourceReference extensible for the deployment-stacks ManagedResourceReference model after deployments generation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Generate deployment clients and models into the combined resources package while preserving premium inner models, UUID types, and ResourceReference inheritance. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Use the package-specific deployment client accessor from the handwritten ResourceManager entry point. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Complete the combined resources package generation with the original client grouping, tag client name, and shared-model compatibility. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add TypeSpec samples for providers, resource groups, provider resource types, and tag operations. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Restore AssignmentScopeValidation required by policy exemption compatibility. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Refresh playback assets for TypeSpec URI casing and trailing slash changes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Allow azure-core to deserialize TypeSpec paging models through reflection. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Regenerate deployment stacks with separate model and delete parameter enum types, document accepted Policy service removals, and suppress reviewed migration differences. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Skip pre-generation source cleanup for azure-resourcemanager-resources so generating one TypeSpec project does not delete outputs from the package's other projects. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Generate the PolicyExemptions accessor without an explicit public modifier on the PolicyClient interface. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Use the core resources project in the Azure azure-rest-api-specs repository as the package's default generation location. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add the Policy Exemptions client accessor and implementation only when the selected API version does not generate them. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

…es-typespec

Remove the task working notes from the pull request while retaining the local file. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Weidong Xu (weidongxu-microsoft) · 2026-08-12T12:58:27Z

Specs PR at Azure/azure-rest-api-specs#45423
We may not merge this one directly, as deploymentStack is moved out, and dataBoundaries may follow.

One major problem is that we need run an extra step to pin other lib (e.g. policy) to generate from stable (in AutoPR), if e.g. resources need to release for next stable.

And if e.g. policy need to release preview, we need then unpin it.

Seems the best we can do is to always pin them at stable. Then only unpin when any need to release a preview.

Another minor problem is a generate will delete all generated samples that not belong to it. Will handle this later, as worst case it still manageable in AutoPR.

Also need a new emitter release for the samples anyway

Fix Java sample client routing microsoft/typespec#11633

Another minor problem is duplicate files (from CommonTypes I guess).

### Policy (11)

- `src/main/java/com/azure/resourcemanager/resources/models/Alias.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPath.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPathAttributes.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPathMetadata.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPathTokenType.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPattern.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPatternType.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasType.java`
- `src/main/java/com/azure/resourcemanager/resources/models/Identity.java`
- `src/main/java/com/azure/resourcemanager/resources/models/IdentityUserAssignedIdentitiesValue.java`
- `src/main/java/com/azure/resourcemanager/resources/models/ResourceIdentityType.java`

### Deployments (14)

- `src/main/java/com/azure/resourcemanager/resources/fluent/models/ProviderInner.java`
- `src/main/java/com/azure/resourcemanager/resources/models/Alias.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPath.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPathAttributes.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPathMetadata.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPathTokenType.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPattern.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasPatternType.java`
- `src/main/java/com/azure/resourcemanager/resources/models/AliasType.java`
- `src/main/java/com/azure/resourcemanager/resources/models/ApiProfile.java`
- `src/main/java/com/azure/resourcemanager/resources/models/ProviderAuthorizationConsentState.java`
- `src/main/java/com/azure/resourcemanager/resources/models/ProviderExtendedLocation.java`
- `src/main/java/com/azure/resourcemanager/resources/models/ProviderResourceType.java`
- `src/main/java/com/azure/resourcemanager/resources/models/ZoneMapping.java`

Likely going to have emitter support remove-model option.

Support remove-model in TypeSpec Java emitter microsoft/typespec#11658

Another emitter fix

Preserve customized properties during SDK integration microsoft/typespec#11635

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Weidong Xu (weidongxu-microsoft) · 2026-08-12T13:10:12Z

+          "code": "java.method.removed",
+          "old": {
+            "matcher": "regex",
+            "match": "method .* com\\.azure\\.resourcemanager\\.resources\\.models\\.PolicyLogInfo\\:\\:(ancestors|complianceReasonCode|policyAssignmentDisplayName|policyDefinitionDisplayName|policyDefinitionGroupNames|policyExemptionIds|policySetDefinitionCategory|policySetDefinitionDisplayName|resourceLocation)\\(\\)"


policy just removed them as "bug fix" https://github.com/Azure/azure-rest-api-specs/pull/43353/changes#diff-c1419a1c98902586e334cf8112deb57a3f3771898cb89038b038a76ea2853b14

Weidong Xu (weidongxu-microsoft) · 2026-08-12T13:21:58Z

This is to handle the mistake we made a long time ago -- we release GA on a tag that includes PolicyExemptions that still is preview.

The client/model class was converted as handwritten. The MangementClient would need a customizatoin.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Copilot

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

azure-pipelines · 2026-08-12T16:26:14Z

Azure Pipelines: Successfully started running 2 pipeline(s). 33 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 156aa207-7554-4621-9b96-07761ca52455

Weidong Xu (weidongxu-microsoft) · 2026-08-13T07:44:13Z

 public class FeaturesTests extends ResourceManagementTest {

+    // Feature availability and registration state are subscription-specific.
+    @DoNotRecord(skipInPlayback = true)


Not sure why this time it continue failing on 1 macos CI.

But also see one case timeout at 120sec. My local run took 50sec.

Guest just disable it in playback.

Weidong Xu (weidongxu-microsoft) and others added 29 commits August 12, 2026 11:39

Remove stale resources generated samples

1f4b041

Remove generated policy samples that are no longer owned by the retained Swagger projects. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Generate resources data boundaries from TypeSpec

f5573c3

Add the data boundaries TypeSpec checkpoint, scoped metadata, and ResourceManager-based generated samples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Document resources TypeSpec migration milestones

9c21b3c

Record the data boundaries checkpoint and reusable workflow for the remaining multi-source generation steps. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Preserve deployment stack property flattening

ca94cc2

Regenerate deployment stacks with the legacy Java properties flattening used by the original Swagger client. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Fix policy interface customization

2350275

Target the generated PolicyClient interface declaration and emit a marker Override annotation on its implementation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Restore policy exemption client access

fa60d91

Apply the Java AST customization to expose the preserved PolicyExemptionsClient through PolicyClient and PolicyClientImpl. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add generated resources subscription samples

1ce90d5

Use the package-specific subscription client accessor from the shared ResourceManager entry point. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Customize deployment resource references

8cf2661

Keep ResourceReference extensible for the deployment-stacks ManagedResourceReference model after deployments generation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add generated resources deployment samples

bb3a027

Use the package-specific deployment client accessor from the handwritten ResourceManager entry point. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Add generated core resources samples

6538252

Add TypeSpec samples for providers, resource groups, provider resource types, and tag operations. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Fix resources sample client accessors

91379fc

Restore AssignmentScopeValidation required by policy exemption compatibility. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Update resources test recordings

c6d1936

Refresh playback assets for TypeSpec URI casing and trailing slash changes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Open resources implementation models to azure-core

370ad15

Allow azure-core to deserialize TypeSpec paging models through reflection. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Remove redundant policy client modifier

97ea520

Generate the PolicyExemptions accessor without an explicit public modifier on the PolicyClient interface. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Merge remote-tracking branch 'upstream/main' into issue-49803-resourc…

d6c74b4

…es-typespec

Keep migration notes local

c9deac1

Remove the task working notes from the pull request while retaining the local file. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

github-actions Bot added the Mgmt This issue is related to a management-plane library. label Aug 12, 2026

Use management exceptions for subscription APIs

e52d53a

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Weidong Xu (weidongxu-microsoft) commented Aug 12, 2026

View reviewed changes

Weidong Xu (weidongxu-microsoft) added 4 commits August 12, 2026 21:57

Disable VM delete-option playback test

02889fa

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Disable generic resources playback test

9cd9361

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Restore premium management library versions

d4450cb

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Disable tagged deployment playback test

704a011

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Weidong Xu (weidongxu-microsoft) marked this pull request as ready for review August 12, 2026 16:25

Copilot AI lite review requested due to automatic review settings August 12, 2026 16:25

Copilot AI reviewed Aug 12, 2026

Weidong Xu (weidongxu-microsoft) added 4 commits August 13, 2026 09:26

Pin policy generation to stable API

7442073

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Fix generated policy sample client access

7fa454e

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Regenerate resources models from TypeSpec

1f2022e

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Use full TypeSpec specification commit

3268ce0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4fc3370c-93f9-4237-862a-f239ff79cc86

Xiaofei Cao (XiaofeiCao) approved these changes Aug 13, 2026

View reviewed changes

Mark feature registration test as live only

f5ad41c

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 156aa207-7554-4621-9b96-07761ca52455

Weidong Xu (weidongxu-microsoft) commented Aug 13, 2026

View reviewed changes

Navigation Menu

Uh oh!

Migrate resource manager resources generation to TypeSpec - #50111

Migrate resource manager resources generation to TypeSpec#50111
Weidong Xu (weidongxu-microsoft) wants to merge 39 commits into
Azure:mainfrom
weidongxu-microsoft:issue-49803-resources-typespec

Weidong Xu (weidongxu-microsoft) commented Aug 12, 2026

Uh oh!

Weidong Xu (weidongxu-microsoft) commented Aug 12, 2026 •

edited

Loading

Uh oh!

Weidong Xu (weidongxu-microsoft) Aug 12, 2026 •

edited

Loading

Uh oh!

Weidong Xu (weidongxu-microsoft) Aug 12, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

azure-pipelines Bot commented Aug 12, 2026

Uh oh!

Weidong Xu (weidongxu-microsoft) Aug 13, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Weidong Xu (weidongxu-microsoft) commented Aug 12, 2026

Summary

Testing

Uh oh!

Weidong Xu (weidongxu-microsoft) commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Weidong Xu (weidongxu-microsoft) Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Weidong Xu (weidongxu-microsoft) Aug 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

azure-pipelines Bot commented Aug 12, 2026

Uh oh!

Weidong Xu (weidongxu-microsoft) Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Weidong Xu (weidongxu-microsoft) commented Aug 12, 2026 •

edited

Loading

Weidong Xu (weidongxu-microsoft) Aug 12, 2026 •

edited

Loading

Weidong Xu (weidongxu-microsoft) Aug 13, 2026 •

edited

Loading