Microsoft.Compute hostGroups 2023-03-01
Bicep resource definition
The hostGroups resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
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@2023-03-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 |
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:
- Resource groups - See resource group deployment commands
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": "2023-03-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 | '2023-03-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 |
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@2023-03-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@2023-03-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 |