Azure · fmabroukmsft · Feb 5, 2026 · Oct 28, 2025 · Oct 28, 2025 · Oct 30, 2025
diff --git a/specification/machinelearningservices/MachineLearningServices.Management/BatchDeployment.tsp b/specification/machinelearningservices/MachineLearningServices.Management/BatchDeployment.tsp
@@ -26,7 +26,7 @@ model BatchDeployment
   /**
    * Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "Existing API includes additional envelope properties"
   kind?: string;
 
   ...Azure.ResourceManager.ResourceSkuProperty;
@@ -81,7 +81,7 @@ interface BatchDeployments {
   /**
    * Delete Batch Inference deployment (asynchronous).
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete Batch Inference deployment (asynchronous).")
   delete is ArmResourceDeleteWithoutOkAsync<
     BatchDeployment,

diff --git a/specification/machinelearningservices/MachineLearningServices.Management/BatchEndpoint.tsp b/specification/machinelearningservices/MachineLearningServices.Management/BatchEndpoint.tsp
@@ -26,7 +26,7 @@ model BatchEndpoint
   /**
    * Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "Existing API includes additional envelope properties"
   kind?: string;
 
   ...Azure.ResourceManager.ResourceSkuProperty;
@@ -81,7 +81,7 @@ interface BatchEndpoints {
   /**
    * Delete Batch Inference Endpoint (asynchronous).
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete Batch Inference Endpoint (asynchronous).")
   delete is ArmResourceDeleteWithoutOkAsync<
     BatchEndpoint,

diff --git a/specification/machinelearningservices/MachineLearningServices.Management/CodeContainer.tsp b/specification/machinelearningservices/MachineLearningServices.Management/CodeContainer.tsp
@@ -81,7 +81,7 @@ interface CodeContainers {
   /**
    * Delete Code container.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete Code container.")
   delete is CodeContainerOps.DeleteWithoutOkAsync<
     CodeContainer,

diff --git a/specification/machinelearningservices/MachineLearningServices.Management/CodeVersion.tsp b/specification/machinelearningservices/MachineLearningServices.Management/CodeVersion.tsp
@@ -87,7 +87,7 @@ interface CodeVersions {
   /**
    * Delete version.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete version.")
   delete is CodeVersionOps.DeleteWithoutOkAsync<
     CodeVersion,

diff --git a/...ication/machinelearningservices/MachineLearningServices.Management/ComponentContainer.tsp b/...ication/machinelearningservices/MachineLearningServices.Management/ComponentContainer.tsp
@@ -81,7 +81,7 @@ interface ComponentContainers {
   /**
    * Delete container.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete container.")
   delete is ComponentContainerOps.DeleteWithoutOkAsync<
     ComponentContainer,

diff --git a/...ification/machinelearningservices/MachineLearningServices.Management/ComponentVersion.tsp b/...ification/machinelearningservices/MachineLearningServices.Management/ComponentVersion.tsp
@@ -87,7 +87,7 @@ interface ComponentVersions {
   /**
    * Delete version.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete version.")
   delete is ComponentVersionOps.DeleteWithoutOkAsync<
     ComponentVersion,

diff --git a/specification/machinelearningservices/MachineLearningServices.Management/ComputeResource.tsp b/specification/machinelearningservices/MachineLearningServices.Management/ComputeResource.tsp
@@ -2,6 +2,7 @@ import "@azure-tools/typespec-azure-core";
 import "@azure-tools/typespec-azure-resource-manager";
 import "@typespec/openapi";
 import "@typespec/rest";
+import "@typespec/versioning";
 import "./models.tsp";
 import "./Workspace.tsp";
 
@@ -10,14 +11,15 @@ using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
 using Azure.Core;
+using TypeSpec.Versioning;
 
 namespace Microsoft.MachineLearningServices;
 // FIXME: ComputeResource has no properties property
 /**
  * Machine Learning compute object wrapped into ARM resource envelope.
  */
-#suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
-#suppress "@azure-tools/typespec-client-generator-core/legacy-hierarchy-building-conflict" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+#suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "Required for backward compatibility"
+#suppress "@azure-tools/typespec-client-generator-core/legacy-hierarchy-building-conflict" "Required for SDK backward compatibility"
 @parentResource(Workspace)
 model ComputeResource is Azure.ResourceManager.ProxyResource<Compute> {
   ...ResourceNameParameter<
@@ -30,22 +32,22 @@ model ComputeResource is Azure.ResourceManager.ProxyResource<Compute> {
   /**
    * Specifies the location of the resource.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
-  #suppress "@azure-tools/typespec-azure-core/no-nullable" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "Existing API includes additional envelope properties"
+  #suppress "@azure-tools/typespec-azure-core/no-nullable" "Existing API contract allows null values"
   location?: string;
 
   /**
    * Contains resource tags defined as key/value pairs.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
-  #suppress "@azure-tools/typespec-azure-core/no-nullable" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "Existing API includes additional envelope properties"
+  #suppress "@azure-tools/typespec-azure-core/no-nullable" "Existing API contract allows null values"
   tags?: Record<string> | null;
 
   /**
    * The sku of the workspace.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
-  #suppress "@azure-tools/typespec-azure-core/no-nullable" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "Existing API includes additional envelope properties"
+  #suppress "@azure-tools/typespec-azure-core/no-nullable" "Existing API contract allows null values"
   sku?: Azure.ResourceManager.Foundations.Sku | null;
 
   ...Azure.ResourceManager.ManagedServiceIdentityProperty;
@@ -61,7 +63,7 @@ interface ComputeResources {
   /**
    * Creates or updates compute. This call will overwrite a compute if it exists. This is a nonrecoverable operation. If your intent is to create a new compute, do a GET first to verify that it does not exist yet.
    */
-  #suppress "@azure-tools/typespec-azure-core/invalid-final-state" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-core/invalid-final-state" "LRO final state pattern matches existing API behavior"
   @Azure.Core.useFinalStateVia("location")
   createOrUpdate is ArmResourceCreateOrReplaceAsync<
     ComputeResource,
@@ -72,7 +74,7 @@ interface ComputeResources {
   /**
    * Updates properties of a compute. This call will overwrite a compute if it exists. This is a nonrecoverable operation.
    */
-  #suppress "@azure-tools/typespec-azure-core/invalid-final-state" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-core/invalid-final-state" "LRO final state pattern matches existing API behavior"
   @Azure.Core.useFinalStateVia("location")
   @patch(#{ implicitOptionality: false })
   update is ArmCustomPatchAsync<
@@ -85,7 +87,7 @@ interface ComputeResources {
   /**
    * Deletes specified Machine Learning compute.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   delete is ArmResourceDeleteWithoutOkAsync<
     ComputeResource,
     Parameters = {
@@ -114,8 +116,9 @@ interface ComputeResources {
   >;
 
   /**
-   * Updates the custom services list. The list of custom services provided shall be overwritten
+   * Updates the custom services list. The list of custom services provided shall be overwritten.
    */
+  @removed(Versions.v2025_12_01)
   @action("customServices")
   updateCustomServices is ArmResourceActionSync<
     ComputeResource,
@@ -147,6 +150,7 @@ interface ComputeResources {
   /**
    * Update Data Mounts of a Machine Learning compute.
    */
+  @removed(Versions.v2025_12_01)
   @summary("Update Data Mounts of a Machine Learning compute.")
   updateDataMounts is ArmResourceActionSync<
     ComputeResource,
@@ -189,6 +193,7 @@ interface ComputeResources {
   /**
    * Updates the idle shutdown setting of a compute instance.
    */
+  @removed(Versions.v2025_12_01)
   updateIdleShutdownSetting is ArmResourceActionSync<
     ComputeResource,
     IdleShutdownSetting,
@@ -198,9 +203,10 @@ interface ComputeResources {
   >;
 
   /**
-   * Returns supported virtual machine sizes for resize
+   * Returns supported virtual machine sizes for resize.
    */
-  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "Required for swagger compatibility"
+  @removed(Versions.v2025_12_01)
   @operationId("Compute_getAllowedResizeSizes")
   @action("getAllowedVmSizesForResize")
   getAllowedResizeSizes is ArmResourceActionSync<
@@ -212,6 +218,7 @@ interface ComputeResources {
   /**
    * Updates the size of a Compute Instance.
    */
+  @removed(Versions.v2025_12_01)
   resize is ArmResourceActionAsyncBase<
     ComputeResource,
     ResizeSchema,

diff --git a/specification/machinelearningservices/MachineLearningServices.Management/DataContainer.tsp b/specification/machinelearningservices/MachineLearningServices.Management/DataContainer.tsp
@@ -108,7 +108,7 @@ interface DataContainers {
   /**
    * Delete container.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete container.")
   delete is DataContainerOps.DeleteWithoutOkAsync<
     DataContainer,

diff --git a/specification/machinelearningservices/MachineLearningServices.Management/DataVersionBase.tsp b/specification/machinelearningservices/MachineLearningServices.Management/DataVersionBase.tsp
@@ -120,7 +120,7 @@ interface DataVersionBases {
   /**
    * Delete version.
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "Existing API returns additional response codes for LRO delete"
   @summary("Delete version.")
   delete is DataVersionBaseOps.DeleteWithoutOkAsync<
     DataVersionBase,

diff --git a/.../MachineLearningServices.Management/EndpointDeploymentResourcePropertiesBasicResource.tsp b/.../MachineLearningServices.Management/EndpointDeploymentResourcePropertiesBasicResource.tsp
@@ -2,16 +2,22 @@ import "@azure-tools/typespec-azure-core";
 import "@azure-tools/typespec-azure-resource-manager";
 import "@typespec/openapi";
 import "@typespec/rest";
+import "@typespec/versioning";
 import "./models.tsp";
 import "./WorkspaceConnectionPropertiesV2BasicResource.tsp";
 
 using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.MachineLearningServices;
 
+/**
+ * EndpointDeploymentResourcePropertiesBasicResource is preview-only.
+ */
+@removed(Versions.v2025_12_01)
 @parentResource(WorkspaceConnectionPropertiesV2BasicResource)
 model EndpointDeploymentResourcePropertiesBasicResource
   is Azure.ResourceManager.ProxyResource<
@@ -26,6 +32,10 @@ model EndpointDeploymentResourcePropertiesBasicResource
   >;
 }
 
+/**
+ * EndpointDeploymentResourcePropertiesBasicResourceOps is preview-only.
+ */
+@removed(Versions.v2025_12_01)
 @armResourceOperations
 interface EndpointDeploymentResourcePropertiesBasicResourceOps
   extends Azure.ResourceManager.Legacy.LegacyOperations<
@@ -59,6 +69,10 @@ interface EndpointDeploymentResourcePropertiesBasicResourceOps
       }
     > {}
 
+/**
+ * EndpointDeploymentResourcePropertiesBasicResources is preview-only.
+ */
+@removed(Versions.v2025_12_01)
 @armResourceOperations
 interface EndpointDeploymentResourcePropertiesBasicResources {
   /**
@@ -74,7 +88,12 @@ interface EndpointDeploymentResourcePropertiesBasicResources {
   createOrUpdateDeployment is EndpointDeploymentResourcePropertiesBasicResourceOps.CreateOrUpdateAsync<
     EndpointDeploymentResourcePropertiesBasicResource,
     Parameters = {
-      ...ProxyApiVersion;
+      /**
+       * Api version used by proxy call
+       */
+      #suppress "@azure-tools/typespec-azure-core/casing-style" "Existing API contract uses this naming convention"
+      @query("proxy-api-version")
+      `proxy-api-version`?: string;
     },
     LroHeaders = ArmLroLocationHeader<FinalResult = EndpointDeploymentResourcePropertiesBasicResource> &
       Azure.Core.Foundations.RetryAfterHeader
@@ -87,7 +106,12 @@ interface EndpointDeploymentResourcePropertiesBasicResources {
   deleteDeployment is EndpointDeploymentResourcePropertiesBasicResourceOps.DeleteWithoutOkAsync<
     EndpointDeploymentResourcePropertiesBasicResource,
     Parameters = {
-      ...ProxyApiVersion;
+      /**
+       * Api version used by proxy call
+       */
+      #suppress "@azure-tools/typespec-azure-core/casing-style" "Existing API contract uses this naming convention"
+      @query("proxy-api-version")
+      `proxy-api-version`?: string;
     }
   >;
 
@@ -98,11 +122,21 @@ interface EndpointDeploymentResourcePropertiesBasicResources {
   listDeployments is EndpointDeploymentResourcePropertiesBasicResourceOps.List<
     EndpointDeploymentResourcePropertiesBasicResource,
     Parameters = {
-      ...ProxyApiVersion;
+      /**
+       * Api version used by proxy call
+       */
+      #suppress "@azure-tools/typespec-azure-core/casing-style" "Existing API contract uses this naming convention"
+      @query("proxy-api-version")
+      `proxy-api-version`?: string;
     },
     Response = ArmResponse<EndpointDeploymentResourcePropertiesBasicResourceArmPaginatedResult>
   >;
 }
+
+/**
+ * EndpointDeploymentOps is preview-only.
+ */
+@removed(Versions.v2025_12_01)
 @armResourceOperations
 interface EndpointDeploymentOps
   extends Azure.ResourceManager.Legacy.LegacyOperations<
@@ -136,6 +170,10 @@ interface EndpointDeploymentOps
       }
     > {}
 
+/**
+ * EndpointDeployment is preview-only.
+ */
+@removed(Versions.v2025_12_01)
 @armResourceOperations
 interface EndpointDeployment {
   /**
@@ -147,7 +185,7 @@ interface EndpointDeployment {
   /**
    * Create or update endpoint deployment resource with the specified parameters
    */
-  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "Existing API returns additional response codes"
   @summary("Create or update endpoint deployment resource with the specified parameters")
   createOrUpdate is EndpointDeploymentOps.CreateOrUpdateAsync<
     EndpointDeploymentResourcePropertiesBasicResource,
@@ -162,7 +200,12 @@ interface EndpointDeployment {
   delete is EndpointDeploymentOps.DeleteWithoutOkAsync<
     EndpointDeploymentResourcePropertiesBasicResource,
     Parameters = {
-      ...ProxyApiVersion;
+      /**
+       * Api version used by proxy call
+       */
+      #suppress "@azure-tools/typespec-azure-core/casing-style" "Existing API contract uses this naming convention"
+      @query("proxy-api-version")
+      `proxy-api-version`?: string;
     }
   >;