TypeSpec Conversion

UNDER CONSTRUCTION

TypeSpec Conversion

Short link: aka.ms/typespec/conversion

Overview

1. Identify the OpenAPI spec version to convert

   • Must be newest version for which SDKs have been generated, regardless of whether it was a stable or preview version

2. Create a folder for your TypeSpec sources, per the TypeSpec Structure Guidelines.

3. In this folder, run the conversion tool:

$ npx @azure-tools/typespec-client-generator-cli convert --swagger-readme ../data-plane/readme.md
OR
$ npx @azure-tools/typespec-client-generator-cli convert --swagger-readme ../resource-manager/readme.md --arm

Links

• https://azure.github.io/typespec-azure/docs/next/howtos/migrate-swagger/get-started
• https://azure.github.io/typespec-azure/docs/howtos/migrate-swagger/migrate-arm-tips