VM, NIC & Disk Hydration API changes for version 2025-02-01-preview

specification/azurestackhci/AzureStackHCI.StackHCIVM.Management/NetworkInterfaces.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;
 
 namespace Microsoft.AzureStackHCI;
 
@@ -43,7 +45,19 @@ interface NetworkInterfaces {
 
   @doc("The operation to update a network interface.")
   @parameterVisibility
-  update is ArmCustomPatchAsync<NetworkInterface>;
+  @removed(Versions.v2025_02_01_preview)
+  @sharedRoute
+  @renamedFrom(Versions.v2025_02_01_preview, "update")
+  updateOld is ArmCustomPatchAsync<NetworkInterface>;
+
+  @doc("The operation to update a network interface.")
+  @parameterVisibility
+  @added(Versions.v2025_02_01_preview)
+  @sharedRoute
+  update is ArmCustomPatchAsync<
+    NetworkInterface,
+    NetworkInterfacesUpdateRequest
+  >;
 
   @doc("The operation to delete a network interface.")
   delete is ArmResourceDeleteWithoutOkAsync<NetworkInterface>;

specification/azurestackhci/AzureStackHCI.StackHCIVM.Management/VirtualHardDisks.tsp

@@ -43,7 +43,16 @@ interface VirtualHardDisks {
   >;
 
   @doc("The operation to update a virtual hard disk.")
-  update is ArmTagsPatchAsync<VirtualHardDisk>;
+  @removed(Versions.v2025_02_01_preview)
+  @sharedRoute
+  @renamedFrom(Versions.v2025_02_01_preview, "update")
+  updateOld is ArmTagsPatchAsync<VirtualHardDisk>;
+
+  @doc("The operation to update a virtual hard disk.")
+  @parameterVisibility
+  @added(Versions.v2025_02_01_preview)
+  @sharedRoute
+  update is ArmCustomPatchAsync<VirtualHardDisk, VirtualHardDisksUpdateRequest>;
 
   @doc("The operation to delete a virtual hard disk.")
   delete is ArmResourceDeleteWithoutOkAsync<VirtualHardDisk>;

specification/azurestackhci/AzureStackHCI.StackHCIVM.Management/examples/2025-02-01-preview/AttestationStatuses_Get.json

@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "api-version": "2025-02-01-preview",
+    "resourceUri": "subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/testrg/providers/Microsoft.HybridCompute/machines/DemoVM"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "default",
+        "type": "Microsoft.AzureStackHCI/virtualMachineInstances/AttestationStatus",
+        "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/testrg/providers/Microsoft.HybridCompute/machines/DemoVM/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default/attestationStatus/default",
+        "properties": {
+          "attestSecureBootEnabled": "Disabled",
+          "attestationCertValidated": "Invalid",
+          "bootIntegrityValidated": "Invalid",
+          "errorMessage": "Attestation token has invalid signature",
+          "healthStatus": "Unhealthy",
+          "linuxKernelVersion": "1.0.0.0",
+          "timestamp": "2023/11/10 9:48"
+        }
+      }
+    }
+  },
+  "operationId": "AttestationStatuses_Get",
+  "title": "GetAttestationStatus"
+}

specification/azurestackhci/AzureStackHCI.StackHCIVM.Management/examples/2025-02-01-preview/GalleryImages_CreateOrUpdate.json

@@ -0,0 +1,100 @@
+{
+  "parameters": {
+    "api-version": "2025-02-01-preview",
+    "galleryImageName": "test-gallery-image",
+    "resource": {
+      "extendedLocation": {
+        "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
+        "type": "CustomLocation"
+      },
+      "location": "West US2",
+      "properties": {
+        "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
+        "imagePath": "C:\\test.vhdx",
+        "osType": "Linux"
+      }
+    },
+    "resourceGroupName": "test-rg",
+    "subscriptionId": "fd3c3665-1729-4b7b-9a38-238e83b0f98b"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "test-gallery-image",
+        "type": "Microsoft.AzureStackHCI/galleryImages",
+        "extendedLocation": {
+          "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
+          "type": "CustomLocation"
+        },
+        "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/galleryImages/test-gallery-image",
+        "location": "West US2",
+        "properties": {
+          "cloudInitDataSource": "NoCloud",
+          "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
+          "hyperVGeneration": "V2",
+          "osType": "Linux",
+          "provisioningState": "Accepted",
+          "status": {
+            "downloadStatus": {
+              "downloadSizeInMB": 9383
+            },
+            "progressPercentage": 100,
+            "provisioningStatus": {
+              "operationId": "79cfc696-44f5-4a68-a620-21850f7e9fb0",
+              "status": "Succeeded"
+            }
+          },
+          "version": {
+            "properties": {
+              "storageProfile": {
+                "osDiskImage": {
+                  "sizeInMB": 30270
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "test-gallery-image",
+        "type": "Microsoft.AzureStackHCI/galleryImages",
+        "extendedLocation": {
+          "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
+          "type": "CustomLocation"
+        },
+        "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/galleryImages/test-galimg3325",
+        "location": "West US2",
+        "properties": {
+          "cloudInitDataSource": "NoCloud",
+          "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
+          "hyperVGeneration": "V2",
+          "osType": "Linux",
+          "provisioningState": "Succeeded",
+          "status": {
+            "downloadStatus": {
+              "downloadSizeInMB": 9383
+            },
+            "progressPercentage": 100,
+            "provisioningStatus": {
+              "operationId": "79cfc696-44f5-4a68-a620-21850f7e9fb0",
+              "status": "Succeeded"
+            }
+          },
+          "version": {
+            "properties": {
+              "storageProfile": {
+                "osDiskImage": {
+                  "sizeInMB": 30270
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "operationId": "GalleryImages_CreateOrUpdate",
+  "title": "PutGalleryImage"
+}

specification/azurestackhci/AzureStackHCI.StackHCIVM.Management/examples/2025-02-01-preview/GalleryImages_CreateOrUpdate_FromVM.json

@@ -0,0 +1,100 @@
+{
+  "parameters": {
+    "api-version": "2025-02-01-preview",
+    "galleryImageName": "test-gallery-image",
+    "resource": {
+      "extendedLocation": {
+        "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
+        "type": "CustomLocation"
+      },
+      "location": "West US2",
+      "properties": {
+        "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
+        "sourceVirtualMachineId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/virtualMachineInstance/test-vm",
+        "osType": "Windows"
+      }
+    },
+    "resourceGroupName": "test-rg",
+    "subscriptionId": "fd3c3665-1729-4b7b-9a38-238e83b0f98b"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "test-gallery-image",
+        "type": "Microsoft.AzureStackHCI/galleryImages",
+        "extendedLocation": {
+          "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
+          "type": "CustomLocation"
+        },
+        "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/galleryImages/test-gallery-image",
+        "location": "West US2",
+        "properties": {
+          "cloudInitDataSource": "NoCloud",
+          "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
+          "hyperVGeneration": "V2",
+          "osType": "Linux",
+          "provisioningState": "Accepted",
+          "status": {
+            "downloadStatus": {
+              "downloadSizeInMB": 9383
+            },
+            "progressPercentage": 100,
+            "provisioningStatus": {
+              "operationId": "79cfc696-44f5-4a68-a620-21850f7e9fb0",
+              "status": "Succeeded"
+            }
+          },
+          "version": {
+            "properties": {
+              "storageProfile": {
+                "osDiskImage": {
+                  "sizeInMB": 30270
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "test-gallery-image",
+        "type": "Microsoft.AzureStackHCI/galleryImages",
+        "extendedLocation": {
+          "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
+          "type": "CustomLocation"
+        },
+        "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/galleryImages/test-galimg3325",
+        "location": "West US2",
+        "properties": {
+          "cloudInitDataSource": "NoCloud",
+          "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
+          "hyperVGeneration": "V2",
+          "osType": "Linux",
+          "provisioningState": "Succeeded",
+          "status": {
+            "downloadStatus": {
+              "downloadSizeInMB": 9383
+            },
+            "progressPercentage": 100,
+            "provisioningStatus": {
+              "operationId": "79cfc696-44f5-4a68-a620-21850f7e9fb0",
+              "status": "Succeeded"
+            }
+          },
+          "version": {
+            "properties": {
+              "storageProfile": {
+                "osDiskImage": {
+                  "sizeInMB": 30270
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "operationId": "GalleryImages_CreateOrUpdate_FromVM",
+  "title": "PutGalleryImage_FromVM"
+}

specification/azurestackhci/AzureStackHCI.StackHCIVM.Management/examples/2025-02-01-preview/GalleryImages_Delete.json

@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2025-02-01-preview",
+    "galleryImageName": "test-gallery-image",
+    "resourceGroupName": "test-rg",
+    "subscriptionId": "fd3c3665-1729-4b7b-9a38-238e83b0f98b"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "http://azure.async.operation/status"
+      }
+    },
+    "204": {
+      "headers": {
+        "azure-asyncoperation": "http://azure.async.operation/status"
+      }
+    }
+  },
+  "operationId": "GalleryImages_Delete",
+  "title": "DeleteGalleryImage"
+}

specification/azurestackhci/AzureStackHCI.StackHCIVM.Management/examples/2025-02-01-preview/GalleryImages_Get.json

@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "api-version": "2025-02-01-preview",
+    "galleryImageName": "test-gallery-image",
+    "resourceGroupName": "test-rg",
+    "subscriptionId": "fd3c3665-1729-4b7b-9a38-238e83b0f98b"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "test-gallery-image",
+        "type": "Microsoft.AzureStackHCI/galleryImages",
+        "extendedLocation": {
+          "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
+          "type": "CustomLocation"
+        },
+        "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/galleryImages/test-gallery-image",
+        "location": "West US2",
+        "properties": {
+          "cloudInitDataSource": "NoCloud",
+          "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
+          "hyperVGeneration": "V1",
+          "identifier": {
+            "offer": "myOfferName",
+            "publisher": "myPublisherName",
+            "sku": "mySkuName"
+          },
+          "osType": "Windows",
+          "provisioningState": "Accepted",
+          "status": {
+            "downloadStatus": {
+              "downloadSizeInMB": 9383
+            },
+            "progressPercentage": 100,
+            "provisioningStatus": {
+              "operationId": "79cfc696-44f5-4a68-a620-21850f7e9fb0",
+              "status": "Succeeded"
+            }
+          },
+          "version": {
+            "name": "1.0.0",
+            "properties": {
+              "storageProfile": {
+                "osDiskImage": {
+                  "sizeInMB": 30270
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "operationId": "GalleryImages_Get",
+  "title": "GetGalleryImage"
+}