[ComputeRP] New apiVersion 2026-04-01

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/VirtualMachineExtensionImage.tsp

@@ -2,12 +2,14 @@ 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";
 
 using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 using Common;
 
 namespace Compute;
@@ -97,6 +99,13 @@ interface VirtualMachineExtensionImages {
       #suppress "@azure-tools/typespec-azure-core/documentation-required"
       @query("$orderby")
       $orderby?: string;
+
+      /**
+       * Expand the response to include additional read-only metadata. Allowed values: `properties` — returns extended metadata (`releaseCategory`, `urgencyLevel`, `runProfile`).
+       */
+      @added(Versions.v2026_04_01)
+      @query("$expand")
+      $expand?: ListVersionsExpandOptions;
     }
   >;
 }

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/VirtualMachineScaleSet.tsp

@@ -496,6 +496,20 @@ interface VirtualMachineScaleSets {
     Response = OkResponse,
     LroHeaders = ArmLroLocationHeader & Azure.Core.Foundations.RetryAfterHeader
   >;
+
+  /**
+   * Migrates one or more virtual machines in a VM scale set to an availability zone.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-post-operation-response-codes" "migrateVMAvailabilityZone is a no-body LRO POST; 202+204 is the accurate contract per LintDiff PostResponseCodes requirements"
+  @tag("VirtualMachineScaleSets")
+  @added(Versions.v2026_04_01)
+  @action("migrateVMAvailabilityZone")
+  migrateVMAvailabilityZone is ComputeResourceActionAsync<
+    VirtualMachineScaleSet,
+    MigrateVMAvailabilityZoneInput,
+    Response = ArmNoContentResponse<"Resource operation accepted.">,
+    LroHeaders = ArmLroLocationHeader & Azure.Core.Foundations.RetryAfterHeader
+  >;
 }
 
 @@doc(VirtualMachineScaleSet.name, "The name of the VM scale set.");
@@ -567,3 +581,7 @@ interface VirtualMachineScaleSets {
   VirtualMachineScaleSets.scaleOut::parameters.body,
   "The input object for ScaleOut API."
 );
+@@doc(
+  VirtualMachineScaleSets.migrateVMAvailabilityZone::parameters.body,
+  "The input object for the MigrateVMAvailabilityZone API."
+);

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/client.tsp

@@ -15,6 +15,15 @@ using Compute;
   "go, javascript"
 );
 
+// networkApiVersion refers to Microsoft.Network API version, not the compute service version.
+// Suppress the name-based heuristic that incorrectly treats it as the service API version parameter.
+@@apiVersion(VirtualMachineScaleSetNetworkProfile.networkApiVersion, false);
+@@apiVersion(
+  VirtualMachineScaleSetUpdateNetworkProfile.networkApiVersion,
+  false
+);
+@@apiVersion(NetworkProfile.networkApiVersion, false);
+
 @@alternateType(
   VirtualMachineScaleSetStorageProfile.diskControllerType,
   string,

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_CancelMigrationToVirtualMachineScaleSet.json

@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}",
+    "availabilitySetName": "myAvailabilitySet"
+  },
+  "responses": {
+    "204": {}
+  },
+  "operationId": "AvailabilitySets_CancelMigrationToVirtualMachineScaleSet",
+  "title": "AvailabilitySet_CancelMigrationToVirtualMachineScaleSet"
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_ConvertToVirtualMachineScaleSet.json

@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}",
+    "availabilitySetName": "myAvailabilitySet",
+    "parameters": {
+      "virtualMachineScaleSetName": "{vmss-name}"
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2026-04-01"
+      }
+    }
+  },
+  "operationId": "AvailabilitySets_ConvertToVirtualMachineScaleSet",
+  "title": "AvailabilitySet_ConvertToVirtualMachineScaleSet_Gen"
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_Create.json

@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2026-04-01",
+    "availabilitySetName": "myAvailabilitySet",
+    "parameters": {
+      "location": "westus",
+      "properties": {
+        "platformFaultDomainCount": 2,
+        "platformUpdateDomainCount": 20
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Classic"
+        },
+        "name": "myAvailabilitySet",
+        "properties": {
+          "platformFaultDomainCount": 2,
+          "platformUpdateDomainCount": 20,
+          "virtualMachineScaleSetMigrationInfo": {
+            "defaultVirtualMachineScaleSetInfo": {
+              "defaultVirtualMachineScaleSet": {
+                "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
+              },
+              "constrainedMaximumCapacity": false
+            },
+            "migrateToVirtualMachineScaleSet": {
+              "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
+            }
+          }
+        },
+        "location": "westus",
+        "type": "Microsoft.Compute/availabilitySets",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet"
+      }
+    }
+  },
+  "operationId": "AvailabilitySets_CreateOrUpdate",
+  "title": "Create an availability set."
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_Create_WithScheduledEventProfile.json

@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2026-04-01",
+    "availabilitySetName": "myAvailabilitySet",
+    "parameters": {
+      "location": "westus",
+      "properties": {
+        "platformFaultDomainCount": 2,
+        "platformUpdateDomainCount": 20
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Classic"
+        },
+        "name": "myAvailabilitySet",
+        "properties": {
+          "scheduledEventsPolicy": {
+            "scheduledEventsAdditionalPublishingTargets": {
+              "eventGridAndResourceGraph": {
+                "enable": true,
+                "scheduledEventsApiVersion": "2020-07-01"
+              }
+            },
+            "userInitiatedRedeploy": {
+              "automaticallyApprove": true
+            },
+            "userInitiatedReboot": {
+              "automaticallyApprove": true
+            },
+            "allInstancesDown": {
+              "automaticallyApprove": true
+            }
+          },
+          "platformFaultDomainCount": 2,
+          "platformUpdateDomainCount": 20
+        },
+        "location": "westus",
+        "type": "Microsoft.Compute/availabilitySets",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet"
+      }
+    }
+  },
+  "operationId": "AvailabilitySets_CreateOrUpdate",
+  "title": "Create an availability set with Scheduled Event Policy."
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_Delete_MaximumSet_Gen.json

@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "availabilitySetName": "aaaaaaaaaaaaaaaaaaaa",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  },
+  "operationId": "AvailabilitySets_Delete",
+  "title": "AvailabilitySet_Delete_MaximumSet_Gen"
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_Delete_MinimumSet_Gen.json

@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "availabilitySetName": "aaaaaaaaaaa",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  },
+  "operationId": "AvailabilitySets_Delete",
+  "title": "AvailabilitySet_Delete_MinimumSet_Gen"
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_Get_MaximumSet_Gen.json

@@ -0,0 +1,78 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "availabilitySetName": "aaaaaaaaaaaa",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "location": "westus",
+        "properties": {
+          "platformFaultDomainCount": 2,
+          "platformUpdateDomainCount": 20,
+          "virtualMachineScaleSetMigrationInfo": {
+            "defaultVirtualMachineScaleSetInfo": {
+              "defaultVirtualMachineScaleSet": {
+                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
+              },
+              "constrainedMaximumCapacity": false
+            },
+            "migrateToVirtualMachineScaleSet": {
+              "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/{vmss-name}"
+            }
+          },
+          "virtualMachines": [
+            {
+              "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
+            }
+          ],
+          "proximityPlacementGroup": {
+            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
+          },
+          "scheduledEventsPolicy": {
+            "scheduledEventsAdditionalPublishingTargets": {
+              "eventGridAndResourceGraph": {
+                "enable": true,
+                "scheduledEventsApiVersion": "2020-07-01"
+              }
+            },
+            "userInitiatedRedeploy": {
+              "automaticallyApprove": true
+            },
+            "userInitiatedReboot": {
+              "automaticallyApprove": true
+            },
+            "allInstancesDown": {
+              "automaticallyApprove": true
+            }
+          },
+          "statuses": [
+            {
+              "code": "aaaaaaaaaaaaaaaaaaaaaaa",
+              "level": "Info",
+              "displayStatus": "aaaaaa",
+              "message": "a",
+              "time": "2021-11-30T12:58:26.522Z"
+            }
+          ]
+        },
+        "sku": {
+          "name": "Classic",
+          "tier": "aaaaaaaaaaaaaa",
+          "capacity": 29
+        },
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet",
+        "name": "myAvailabilitySet",
+        "type": "Microsoft.Compute/availabilitySets",
+        "tags": {
+          "key9626": "aaaaaaaaaaaaaaaaaaaa",
+          "key2505": "aa"
+        }
+      }
+    }
+  },
+  "operationId": "AvailabilitySets_Get",
+  "title": "AvailabilitySet_Get_MaximumSet_Gen"
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_Get_MinimumSet_Gen.json

@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "availabilitySetName": "aaaaaaaaaaaaaaaaaaaa",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "location": "westus",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet"
+      }
+    }
+  },
+  "operationId": "AvailabilitySets_Get",
+  "title": "AvailabilitySet_Get_MinimumSet_Gen"
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_ListAvailableSizes_MaximumSet_Gen.json

@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "availabilitySetName": "aaaaaaaaaaaaaaaaaaaa",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Standard_A1_V2",
+            "numberOfCores": 1,
+            "osDiskSizeInMB": 1047552,
+            "resourceDiskSizeInMB": 10240,
+            "memoryInMB": 2048,
+            "maxDataDiskCount": 2
+          },
+          {
+            "name": "Standard_A2_V2",
+            "numberOfCores": 2,
+            "osDiskSizeInMB": 1047552,
+            "resourceDiskSizeInMB": 20480,
+            "memoryInMB": 4096,
+            "maxDataDiskCount": 4
+          }
+        ]
+      }
+    }
+  },
+  "operationId": "AvailabilitySets_ListAvailableSizes",
+  "title": "AvailabilitySet_ListAvailableSizes_MaximumSet_Gen"
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-04-01/availabilitySetExamples/AvailabilitySet_ListAvailableSizes_MinimumSet_Gen.json

@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "resourceGroupName": "rgcompute",
+    "availabilitySetName": "aa",
+    "api-version": "2026-04-01",
+    "subscriptionId": "{subscription-id}"
+  },
+  "responses": {
+    "200": {
+      "body": {}
+    }
+  },
+  "operationId": "AvailabilitySets_ListAvailableSizes",
+  "title": "AvailabilitySet_ListAvailableSizes_MinimumSet_Gen"
+}