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.
AutoRest 3.0 finally supports OpenAPI3 files as an input format, with the following caveats:
- existing AutoRest v2 generators may not support all features from OpenAPI3. (see next section)
anyOf
,oneOf
are not currently supported- other OpenAPI3 specific features may not be entirely supported.
A new set of language generator plugins are being written that adopt the lighter-weight patterns for Azure Core libraries.
Existing V2 generators will default to processing with the AutoRest 2 pipeline.
See the language generator flags here
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: