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. Resource action template body could not support primitive type #57
   external:mgmt external:swagger-converter +2
4. List operation with additional response property #59
   Brownfield MPG Impact external:mgmt external:swagger-converter +4
5. 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
6. Resource type is enum #63
   Brownfield MPG Impact Out of Scope external:mgmt external:swagger-converter +5
7. https://github.com/Azure/typespec-azure-pr/issues/3761
8. https://github.com/Azure/typespec-azure-pr/issues/3764
9. https://github.com/Azure/typespec-azure-pr/issues/3765
10. https://github.com/Azure/typespec-azure-pr/issues/3774
11. https://github.com/Azure/typespec-azure-pr/issues/3775
12. Spread of Record<T> into a model microsoft/typespec#2442
    design:needed triaged:core +2
    
13. https://github.com/Azure/typespec-azure-pr/issues/3675
14. Problem to decorate resource key property with @path #103
    external:mgmt external:swagger-converter +2
    

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

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

    
17. [Bug] ArmResourceListByParent does not respect operation name but hard code to ListByResourceGroup. #37
    external:mgmt external:swagger-converter +2
    
18. Param sequence for arm resource #130
    Blocking MPG Impact More Info external:mgmt +4
19. Customization for arm build-in model's visibility and optional setting for resource properties property #131
    external:mgmt +1
    
20. Auto generated model for write operation #132
    MPG Impact external:mgmt +2
21. https://github.com/Azure/typespec-azure-pr/issues/3763
22. 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] Move generated operations to ResourceOperations interface autorest#4753
   DataPlane Feature openapi-to-tsp +2
   
4. [openapi-to-tsp] Improve tspconfig.yaml autorest#4787
   DataPlane Feature Mgmt openapi-to-tsp +3
   
5. [openapi-to-tsp] Camel case operation names autorest#4788
   Mgmt openapi-to-tsp +2
   
6. [openapi-to-tsp] Emit authentication defintion autorest#4791
   Mgmt openapi-to-tsp +2
   
7. [openapi-to-tsp] Node 20 produce different output for openai spec autorest#4795
   Mgmt bug openapi-to-tsp +3
   
8. Add support for new ARM LRO header autorest#4847
   Mgmt openapi-to-tsp +2
   
9. Body param name is not same with the original swagger autorest#4832
   Mgmt openapi-to-tsp +2
   
10. [TSP] Support flatten in TSP conversion tool autorest#4850
    Mgmt greenfield openapi-to-tsp +3
    
11. Docs for body parameter is different from the original swagger autorest#4848
    Mgmt openapi-to-tsp +2
    
12. Migrate examples to TSP autorest#4859
    Mgmt openapi-to-tsp +2
    
13. Swagger converter: switch from @doc to /** */ #123
    external:mgmt external:swagger-converter +2
    
14. Support self-defined common-type resources autorest#4861
    Mgmt openapi-to-tsp +2
    
15. Support custom operation in resource operation groups autorest#4862
    Mgmt greenfield openapi-to-tsp +3

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
   
6. [MPG] Generate diff of generated SDK between swagger and typespec autorest.python#2312
   discussion mgmt +2
   

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