Changes related to dedicated host group automatic placement

specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/compute.json

@@ -782,6 +782,20 @@
             "type": "string",
             "description": "The name of the dedicated host group."
           },
+          {
+            "name": "$expand",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "The expand expression to apply on the operation.",
+            "enum": [
+              "instanceView"
+            ],
+            "x-ms-enum": {
+              "name": "InstanceViewTypes",
+              "modelAsString": false
+            }
+          },
           {
             "$ref": "#/parameters/ApiVersionParameter"
           },
@@ -6629,6 +6643,16 @@
       ],
       "description": "The List Proximity Placement Group operation response."
     },
+    "DedicatedHostGroupInstanceView": {
+      "properties": {
+        "hosts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DedicatedHostInstanceViewWithName"
+          }
+        }
+      }
+    },
     "DedicatedHostGroupProperties": {
       "properties": {
         "platformFaultDomainCount": {
@@ -6645,6 +6669,15 @@
           },
           "readOnly": true,
           "description": "A list of references to all dedicated hosts in the dedicated host group."
+        },
+        "instanceView": {
+          "$ref": "#/definitions/DedicatedHostGroupInstanceView",
+          "readOnly": true,
+          "description": "The dedicated host group instance view."
+        },
+        "supportAutomaticPlacement": {
+          "type": "boolean",
+          "description": "Specifies whether virtual machines or virtual machine scale sets can be placed automatically on the dedicated host group. Automatic placement means resources are allocated on dedicated hosts, that are chosen by Azure, under the dedicated host group. The value is defaulted to 'true' when not provided."
         }
       },
       "required": [
@@ -6773,6 +6806,20 @@
       },
       "description": "The instance view of a dedicated host."
     },
+    "DedicatedHostInstanceViewWithName": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the dedicated host."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "description": "The instance view of a dedicated host."
+    },
     "DedicatedHostProperties": {
       "properties": {
         "platformFaultDomain": {
@@ -8597,6 +8644,10 @@
           "$ref": "#/definitions/BootDiagnosticsInstanceView",
           "description": "Boot Diagnostics is a debugging feature which allows you to view Console Output and Screenshot to diagnose VM status. <br><br> You can easily view the output of your console log. <br><br> Azure also enables you to see a screenshot of the VM from the hypervisor."
         },
+        "assignedHost": {
+          "type": "string",
+          "description": "Resource id of the dedicated host, on which the virtual machine is allocated through automatic placement."
+        },
         "statuses": {
           "type": "array",
           "items": {
@@ -8665,6 +8716,10 @@
           "$ref": "#/definitions/SubResource",
           "description": "Specifies information about the dedicated host that the virtual machine resides in. <br><br>Minimum api-version: 2018-10-01."
         },
+        "hostGroup": {
+          "$ref": "#/definitions/SubResource",
+          "description": "Specifies information about the dedicated host group that the virtual machine resides in. <br><br>Minimum api-version: 2020-06-01."
+        },
         "provisioningState": {
           "readOnly": true,
           "type": "string",
@@ -10060,6 +10115,10 @@
           "$ref": "#/definitions/SubResource",
           "description": "Specifies information about the proximity placement group that the virtual machine scale set should be assigned to. <br><br>Minimum api-version: 2018-04-01."
         },
+        "hostGroup": {
+          "$ref": "#/definitions/SubResource",
+          "description": "Specifies information about the dedicated host group that the virtual machine scale set resides in. <br><br>Minimum api-version: 2020-06-01."
+        },
         "additionalCapabilities": {
           "$ref": "#/definitions/AdditionalCapabilities",
           "description": "Specifies additional capabilities enabled or disabled on the Virtual Machines in the Virtual Machine Scale Set. For instance: whether the Virtual Machines have the capability to support attaching managed data disks with UltraSSD_LRS storage account type."

specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/CreateOrUpdateADedicatedHostGroup.json

@@ -2,7 +2,7 @@
   "parameters": {
     "subscriptionId": "{subscription-id}",
     "resourceGroupName": "myResourceGroup",
-    "api-version": "2018-10-01",
+    "api-version": "2020-06-01",
     "hostGroupName": "myDedicatedHostGroup",
     "parameters": {
       "location": "westus",
@@ -13,7 +13,8 @@
         "1"
       ],
       "properties": {
-        "platformFaultDomainCount": 3
+        "platformFaultDomainCount": 3,
+        "supportAutomaticPlacement": true
       }
     }
   },
@@ -31,15 +32,17 @@
         ],
         "properties": {
           "platformFaultDomainCount": 3,
-          "hosts": []
+          "hosts": [],
+          "supportAutomaticPlacement": true
         }
       }
     },
     "200": {
       "body": {
         "properties": {
           "platformFaultDomainCount": 3,
-          "hosts": []
+          "hosts": [],
+          "supportAutomaticPlacement": true
         },
         "location": "westus",
         "tags": {

specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/GetADedicatedHostGroup.json

@@ -2,7 +2,7 @@
   "parameters": {
     "subscriptionId": "{subscriptionId}",
     "resourceGroupName": "myResourceGroup",
-    "api-version": "2018-10-01",
+    "api-version": "2020-06-01",
     "hostGroupName": "myDedicatedHostGroup"
   },
   "responses": {
@@ -17,7 +17,60 @@
             {
               "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/myDedicatedHostGroup/myHostGroup/Hosts/myHost2"
             }
-          ]
+          ],
+          "supportAutomaticPlacement": true,
+          "instanceView": {
+            "hosts": [
+              {
+                "name": "myHost1",
+                "assetId": "eb3f58b8-b4e8-4882-b69f-301a01812407",
+                "availableCapacity": {
+                  "allocatableVMs": [
+                    {
+                      "vmSize": "Standard_A1",
+                      "count": 10
+                    }
+                  ]
+                },
+                "statuses": [
+                  {
+                    "code": "ProvisioningState/succeeded",
+                    "level": "Info",
+                    "displayStatus": "Provisioning succeeded"
+                  },
+                  {
+                    "code": "HealthState/available",
+                    "level": "Info",
+                    "displayStatus": "Host available"
+                  }
+                ]
+              },
+              {
+                "name": "myHost2",
+                "assetId": "f293d4ac-5eea-4be2-b0c0-0fcaa09aebf8",
+                "availableCapacity": {
+                  "allocatableVMs": [
+                    {
+                      "vmSize": "Standard_A1",
+                      "count": 10
+                    }
+                  ]
+                },
+                "statuses": [
+                  {
+                    "code": "ProvisioningState/succeeded",
+                    "level": "Info",
+                    "displayStatus": "Provisioning succeeded"
+                  },
+                  {
+                    "code": "HealthState/available",
+                    "level": "Info",
+                    "displayStatus": "Host available"
+                  }
+                ]
+              }
+            ]
+          }
         },
         "location": "westus",
         "tags": {

specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/GetVirtualMachineInstanceView.json

@@ -64,6 +64,7 @@
           "consoleScreenshotBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.screenshot.bmp",
           "serialConsoleLogBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.serialconsole.log"
         },
+        "assignedHost": "/subscriptions/{subscription-Id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/myDedicatedHostGroup/myHostGroup/Hosts/myHost",
         "extensions": [
           {
             "name": "IaaSAntiMalware-ext0",