Migrating from AutoRest V2 to V3
September 4, 2024 ยท View on GitHub
General Guidance
First, make sure when generating you are using AutoRest V3. Follow the steps in our installation section for information on upgrading and confirming your new AutoRest version.
New Features
OpenAPI3 support!
AutoRest 3.0 finally supports OpenAPI3 files as an input format, with the following caveats:
anyOf,oneOfare not currently supported- other OpenAPI3 specific features may not be entirely supported.
Generators - Breaking
A new set of language generator plugins are being written that adopt the lighter-weight patterns for Azure Core libraries.
The older generators are only compatible with Autorest V2.
| Generator | Packages names | Autorest Core |
|---|---|---|
| V2 (Track1) | @microsoft.azure/autorest.<language> | 2.x |
| V3 (Track2) | @autorest/<language> | 3.x |
Generate More Idiomatic SDKs
Support for track 2 SDKs that follow the guidelines listed here
For language-specific information about migration and changes, please refer to our language-specific documentation: