Contribute to the Swagger-to-TypeSpec Converter for Mgmt. Plane APIs

[ArthurMa1978]

TSP tasks

TSP syntax could not express some of the ARM usages, and this part needs fix from TSP.

TSP tasks

Beta Give feedback

1. Limitation for tsp to handle operation id from swagger #55
   Blocking MPG Impact external:mgmt external:swagger-converter needs-area +5
2. Resource type has key property same with the parent #56
   Blocking MPG Impact external:mgmt external:swagger-converter needs-area +5
3. List operation with additional response property #59
   Brownfield MPG Impact external:mgmt external:swagger-converter +4
4. How to deal with cross package resource or models reference #62
   Brownfield MPG Impact Out of Scope external:mgmt external:swagger-converter needs-area +6
5. Resource type is enum #63
   Brownfield MPG Impact Out of Scope external:mgmt external:swagger-converter +5
6. https://github.com/Azure/typespec-azure-pr/issues/3761
7. https://github.com/Azure/typespec-azure-pr/issues/3764
8. https://github.com/Azure/typespec-azure-pr/issues/3765
9. https://github.com/Azure/typespec-azure-pr/issues/3774
10. https://github.com/Azure/typespec-azure-pr/issues/3775
11. Spread of Record<T> into a model microsoft/typespec#2442
    design:needed triaged:core +2
    
12. https://github.com/Azure/typespec-azure-pr/issues/3675
13. Problem to decorate resource key property with @path #103
    external:mgmt external:swagger-converter +2
    

    
14. resource model changes of generated SDK code based on TSP compared with swagger #104
    Blocking MPG Impact More Info external:mgmt +4
    

    
15. final-state-via could not be modeled in tsp #105
    external:mgmt +1
    

    
16. [Bug] ArmResourceListByParent does not respect operation name but hard code to ListByResourceGroup. #37
    external:mgmt external:swagger-converter +2
    
17. Param sequence for arm resource #130
    Blocking MPG Impact More Info external:mgmt +4
18. Customization for arm build-in model's visibility and optional setting for resource properties property #131
    external:mgmt +1
    
19. Auto generated model for write operation #132
    MPG Impact external:mgmt +2
20. https://github.com/Azure/typespec-azure-pr/issues/3763
21. https://github.com/Azure/typespec-azure-pr/issues/3739

Converter tasks
Converter tool issues / tasks.

Converter tasks

Beta Give feedback

1. Support check name availability operation template autorest#4858
   Mgmt openapi-to-tsp +2
   
2. Refine list related operation autorest#4857
   Mgmt brownfield openapi-to-tsp +3
3. [openapi-to-tsp] Improve tspconfig.yaml autorest#4787
   DataPlane Feature Mgmt openapi-to-tsp +3
   
4. [openapi-to-tsp] Camel case operation names autorest#4788
   Mgmt openapi-to-tsp +2
   
5. [openapi-to-tsp] Emit authentication defintion autorest#4791
   Mgmt openapi-to-tsp +2
   
6. [openapi-to-tsp] Node 20 produce different output for openai spec autorest#4795
   Mgmt bug openapi-to-tsp +3
   
7. Add support for new ARM LRO header autorest#4847
   Mgmt openapi-to-tsp +2
   
8. Body param name is not same with the original swagger autorest#4832
   Mgmt openapi-to-tsp +2
   
9. [TSP] Support flatten in TSP conversion tool autorest#4850
   Mgmt greenfield openapi-to-tsp +3
   
10. Docs for body parameter is different from the original swagger autorest#4848
    Mgmt openapi-to-tsp +2
    
11. Migrate examples to TSP autorest#4859
    Mgmt openapi-to-tsp +2
    
12. Swagger converter: switch from @doc to /** */ #123
    external:mgmt external:swagger-converter +2
    
13. Support self-defined common-type resources autorest#4861
    Mgmt openapi-to-tsp +2
    

Other tasks
Some will be resolved by converter, some need TSP support, need feature investigation.

Other tasks

Beta Give feedback

1. https://github.com/Azure/typespec-azure-pr/issues/3760
2. https://github.com/Azure/typespec-azure-pr/issues/3775
3. How to convert swagger with batch config to TSP #60
   Brownfield MPG Impact More Info external:mgmt external:swagger-converter +5
4. Service using mix API versions conversion question #106
   Brownfield MPG Impact design:needed external:mgmt +4
   

   
5. [bug] getLroMetadata return wrong finalStateVia #310
   MPG Impact bug lib:azure-core +3
   

RPs in conversion
#78

Related links

• https://github.com/Azure/autorest/issues?page=1&q=is%3Aissue+is%3Aopen+label%3Aopenapi-to-tsp
• https://github.com/Azure/typespec-azure/issues?q=is%3Aopen+is%3Aissue+label%3A%22Swagger+Converter%22
• https://github.com/Azure/typespec-azure-pr/issues?q=is%3Aopen+is%3Aissue+label%3A%22Swagger+Converter%22