Share via

Microsoft.Compute hostGroups 2022-11-01

  • Article

Bicep resource definition

The hostGroups resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Compute/hostGroups resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Compute/hostGroups@2022-11-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    additionalCapabilities: {
      ultraSSDEnabled: bool
    }
    platformFaultDomainCount: int
    supportAutomaticPlacement: bool
  }
  zones: [
    'string' or int
  ]
}

Property values

hostGroups

Name Description Value
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. Array of availability zones as string or int.

DedicatedHostGroupProperties

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

DedicatedHostGroupPropertiesAdditionalCapabilities

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

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Azure Dedicated Hosts

Deploy to Azure		 This will deploy an isolated environment using Azure Dedicated Hosts for you to provision VMs.

ARM template resource definition

The hostGroups resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Compute/hostGroups resource, add the following JSON to your template.

{
  "type": "Microsoft.Compute/hostGroups",
  "apiVersion": "2022-11-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "additionalCapabilities": {
      "ultraSSDEnabled": "bool"
    },
    "platformFaultDomainCount": "int",
    "supportAutomaticPlacement": "bool"
  },
  "zones": [ "string" or int ]
}

Property values

hostGroups

Name Description Value
type The resource type 'Microsoft.Compute/hostGroups'
apiVersion The resource api version '2022-11-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. Array of availability zones as string or int.

DedicatedHostGroupProperties

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

DedicatedHostGroupPropertiesAdditionalCapabilities

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

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Azure Dedicated Hosts

Deploy to Azure		 This will deploy an isolated environment using Azure Dedicated Hosts for you to provision VMs.

Terraform (AzAPI provider) resource definition

The hostGroups resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Compute/hostGroups resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/hostGroups@2022-11-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      additionalCapabilities = {
        ultraSSDEnabled = bool
      }
      platformFaultDomainCount = int
      supportAutomaticPlacement = bool
    }
    zones = [
      "string" or int
    ]
  })
}

Property values

hostGroups

Name Description Value
type The resource type "Microsoft.Compute/hostGroups@2022-11-01"
name The resource name string (required)
location Resource location string (required)
parent_id To deploy to a resource group, use the ID of that resource group. string (required)
tags Resource tags Dictionary of tag names and values.
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. Array of availability zones as string or int.

DedicatedHostGroupProperties

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

DedicatedHostGroupPropertiesAdditionalCapabilities

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