The hostGroups resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
To create a Microsoft.Compute/hostGroups resource, add the following JSON to your template.
{
"type": "Microsoft.Compute/hostGroups",
"apiVersion": "2023-09-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"additionalCapabilities": {
"ultraSSDEnabled": "bool"
},
"platformFaultDomainCount": "int",
"supportAutomaticPlacement": "bool"
},
"zones": [ "string" ]
}
Name | Description | Value |
---|---|---|
type | The resource type | 'Microsoft.Compute/hostGroups' |
apiVersion | The resource api version | '2023-09-01' |
name | The resource name | string (required) |
location | Resource location | string (required) |
tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
properties | Dedicated Host Group Properties. | DedicatedHostGroupProperties |
zones | Availability Zone to use for this host group. Only single zone is supported. The zone can be assigned only during creation. If not provided, the group supports all zones in the region. If provided, enforces each host in the group to be in the same zone. | string[] |
Name | Description | Value |
---|---|---|
additionalCapabilities | Enables or disables a capability on the dedicated host group. Minimum api-version: 2022-03-01. | DedicatedHostGroupPropertiesAdditionalCapabilities |
platformFaultDomainCount | Number of fault domains that the host group can span. | int (required) Constraints: Min value = 1 |
supportAutomaticPlacement | 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 'false' when not provided. Minimum api-version: 2020-06-01. | bool |
Name | Description | Value |
---|---|---|
ultraSSDEnabled | The flag that enables or disables a capability to have UltraSSD Enabled Virtual Machines on Dedicated Hosts of the Dedicated Host Group. For the Virtual Machines to be UltraSSD Enabled, UltraSSDEnabled flag for the resource needs to be set true as well. The value is defaulted to 'false' when not provided. Please refer to /azure/virtual-machines/disks-enable-ultra-ssd for more details on Ultra SSD feature. Note: The ultraSSDEnabled setting can only be enabled for Host Groups that are created as zonal. Minimum api-version: 2022-03-01. | bool |
The following quickstart templates deploy this resource type.
Template | Description |
---|---|
Azure Dedicated Hosts |
This will deploy an isolated environment using Azure Dedicated Hosts for you to provision VMs. |