Compare python SDK for compute TypeSpec migration

[live1206]

We are working on the compute TypeSpec migration.
Would like python to verify the SDK generation of the corresponding swagger of the converted TypeSpec.
We have split compute into multiple sub services and done the conversion for each of them.

For instance, Compute sub-service:

• https://github.com/Azure/azure-rest-api-specs/blob/feature/cplat-typespecTest/specification/compute/Compute.Management/readme.md is the readme containing input files of original swaggers.
• https://github.com/Azure/azure-rest-api-specs/blob/feature/cplat-typespecTest/specification/compute/Compute.Management contains the converted TypeSpec, we need to compile them firstly to get the corresponding swgger then generate SDK
• Get diff from the generated SDK from original swagger and new swagger

[github-actions]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @amjads1 @Drewm3 @GabstaMSFT @sandeepraichura @TravisCragg-MSFT.

[msyyc]

SDK from swagger:

• PR [compute] Update readme.md (only for test) azure-rest-api-specs#31725
• generated SDK https://github.com/azure-sdk/azure-sdk-for-python/pull/9574/files

SDK from typespec:

• typespec: https://github.com/Azure/azure-rest-api-specs/blob/feature/cplat-typespecTest-python/specification/compute/Compute.Management/tspconfig.yaml
• generated SDK: https://github.com/msyyc/azure-sdk-for-python/tree/compute-from-tsp/sdk/compute/azure-mgmt-compute/azure
• breakings: https://github.com/msyyc/azure-sdk-for-python/blob/compute-from-tsp/sdk/compute/azure-mgmt-compute/CHANGELOG.md

SDK from swagger generated from typespec

• PR update python config (only for test) azure-rest-api-specs#32153
• generated SDK [AutoPR azure-mgmt-compute] update python config (only for test) azure-sdk/azure-sdk-for-python#9845
• breaking change: https://github.com/msyyc/azure-sdk-for-python/blob/compute-2025-01-17/sdk/compute/azure-mgmt-compute/CHANGELOG.md

[msyyc]

Breakings that may be caused by Typespec migration:

• AvailabilitySet change inheritance from Resource to TrackedResource
• Resource removed property location/tags
• RestorePointSourceVMOSDisk is renamed to RestorePointSourceVmosDisk
• Enum AvailabilitySetSkuTypes is removed
• ResourceWithOptionalLocation is removed
• Some method (e.g. AvailabilitySetsOperations.create_or_update) renamed signature parameters to resource
• Method VirtualMachineExtensionsOperations.begin_create_or_update/VirtualMachineScaleSetExtensionsOperations.begin_create_or_update/Method VirtualMachineScaleSetVMExtensionsOperations.begin_create_or_update renamed signature extension_parameters to resource
• Method VirtualMachineScaleSetVMRunCommandsOperations.begin_create_or_update renamed signature run_command to body
• Method VirtualMachineRunCommandsOperations.begin_create_or_update renamed signatureextension_parameters to body
• (RemovedOrRenamedClass): Deleted or renamed operation group LogAnalyticsOperations
• (RemovedOrRenamedClass): Deleted or renamed operation group SshPublicKeysOperations
• (RemovedOrRenamedClass): Deleted or renamed operation group UsageOperations
• (RemovedOrRenamedClass): Deleted or renamed operation group VirtualMachineImagesEdgeZoneOperations
• (RemovedOrRenamedClass): Deleted or renamed operation group VirtualMachineImagesOperations
• (RemovedOrRenamedClass): Deleted or renamed operation group VirtualMachineScaleSetRollingUpgradesOperations
• (RemovedOrRenamedClass): Deleted or renamed operation group VirtualMachineScaleSetVMsOperations
• (RemovedOrRenamedClass): Deleted or renamed operation group VirtualMachineSizesOperations
• (RemovedOrRenamedClassMethod): Deleted or renamed method VirtualMachinesOperations.list_by_location
• (RemovedOrRenamedClassMethod): Deleted or renamed method VirtualMachineScaleSetsOperations.list_by_location
• (RemovedOrRenamedClassMethod): Deleted or renamed method VirtualMachineRunCommandsOperations.get
• (RemovedOrRenamedClassMethod): Deleted or renamed method VirtualMachineRunCommandsOperations.list

[msyyc]

Python SDK domain breakings:

• flatten
• Enum NetworkApiVersion renamed TWO_THOUSAND_TWENTY11_01 to ENUM_2020_11_01
• All header/query signatures changes from positional to keyword only. (expected)
• (ChangedParameterOrdering): Method VirtualMachineExtensionImagesOperations.list_versions re-ordered its parameters from ['self', 'location', 'publisher_name', 'type', 'filter', 'top', 'orderby', 'kwargs'] to ['self', 'location', 'publisher_name', 'type', '_filter', '_top', '_orderby', 'kwargs'] (track issue [bug] naming breaking when migrate swagger to typespec autorest.python#2979)

[msyyc]

Python SDK domain breakings but not influence SDK users:

• Removed some models (e.g. ComputeOperationValue/ListUsagesResult/VirtualMachineScaleSetListOSUpgradeHistory but not influence SDK users.

[melina5656]

Hi @msyyc，the issue of the removal of location and tags from the Resource seems to be unchangeable, as it exists in node_modules. Do you have any solutions?