Microsoft. Compute hostGroups 2025-11-01

Definizione della risorsa Bicep

Il tipo di risorsa hostGroups può essere distribuito con operazioni destinate a:

  • Resource groups - Vedi resource group

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/hostGroups, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Compute/hostGroups@2025-11-01' = {
  location: 'string'
  name: 'string'
  properties: {
    additionalCapabilities: {
      ultraSSDEnabled: bool
    }
    platformFaultDomainCount: int
    supportAutomaticPlacement: bool
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valori delle proprietà

Microsoft.Compute/hostGroups

Name Description Value
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa stringa (obbligatorio)
proprietà Proprietà del gruppo host dedicato. Proprietà del gruppo host dedicato
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedi tag nei template
zone Zone di disponibilità. string[]

Proprietà del gruppo host dedicato

Name Description Value
Funzionalità aggiuntive Abilita o disabilita una funzionalità nel gruppo host dedicato. Versione minima api: 2022-03-01. DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount Numero di domini di errore che il gruppo host può estendersi. int

Vincoli:
Valore minimo = 1 (obbligatorio)
di supportoAutomaticoPosizionamento Specifica se le macchine virtuali o i set di scalabilità di macchine virtuali possono essere posizionati automaticamente nel gruppo host dedicato. Il posizionamento automatico indica che le risorse vengono allocate in host dedicati, scelti da Azure, nel gruppo host dedicato. Il valore predefinito è 'false' se non specificato. Versione minima api: 2020-06-01. bool

DedicatedHostGroupPropertiesAdditionalCapabilities

Name Description Value
ultraSSDEnabled Flag che abilita o disabilita una funzionalità per cui è abilitato UltraSSD Macchine virtuali negli host dedicati del gruppo host dedicato. Affinché la Macchine virtuali sia abilitata per UltraSSD, anche il flag UltraSSDEnabled per la risorsa deve essere impostato su true. Il valore predefinito è 'false' se non specificato. Per altre informazioni sulla funzionalità Ultra SSD, vedere /azure/virtual-machines/disks-enable-ultra-ssd. Nota: L'impostazione ultraSSDEnabled può essere abilitata solo per i gruppi host creati come zona. Versione minima api: 2022-03-01. bool

TrackedResourceTags

Name Description Value

Esempi di utilizzo

Esempi di Bicep

Un esempio di base di distribuzione di un gruppo host dedicato.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource hostGroup 'Microsoft.Compute/hostGroups@2021-11-01' = {
  name: resourceName
  location: location
  properties: {
    platformFaultDomainCount: 2
  }
}

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa hostGroups può essere distribuito con operazioni destinate a:

  • Resource groups - Vedi resource group

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/hostGroups, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Compute/hostGroups",
  "apiVersion": "2025-11-01",
  "name": "string",
  "location": "string",
  "properties": {
    "additionalCapabilities": {
      "ultraSSDEnabled": "bool"
    },
    "platformFaultDomainCount": "int",
    "supportAutomaticPlacement": "bool"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valori delle proprietà

Microsoft.Compute/hostGroups

Name Description Value
apiVersion Versione dell'API '2025-11-01'
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa stringa (obbligatorio)
proprietà Proprietà del gruppo host dedicato. Proprietà del gruppo host dedicato
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedi tag nei template
type Tipo di risorsa 'Microsoft.Compute/hostGroups'
zone Zone di disponibilità. string[]

Proprietà del gruppo host dedicato

Name Description Value
Funzionalità aggiuntive Abilita o disabilita una funzionalità nel gruppo host dedicato. Versione minima api: 2022-03-01. DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount Numero di domini di errore che il gruppo host può estendersi. int

Vincoli:
Valore minimo = 1 (obbligatorio)
di supportoAutomaticoPosizionamento Specifica se le macchine virtuali o i set di scalabilità di macchine virtuali possono essere posizionati automaticamente nel gruppo host dedicato. Il posizionamento automatico indica che le risorse vengono allocate in host dedicati, scelti da Azure, nel gruppo host dedicato. Il valore predefinito è 'false' se non specificato. Versione minima api: 2020-06-01. bool

DedicatedHostGroupPropertiesAdditionalCapabilities

Name Description Value
ultraSSDEnabled Flag che abilita o disabilita una funzionalità per cui è abilitato UltraSSD Macchine virtuali negli host dedicati del gruppo host dedicato. Affinché la Macchine virtuali sia abilitata per UltraSSD, anche il flag UltraSSDEnabled per la risorsa deve essere impostato su true. Il valore predefinito è 'false' se non specificato. Per altre informazioni sulla funzionalità Ultra SSD, vedere /azure/virtual-machines/disks-enable-ultra-ssd. Nota: L'impostazione ultraSSDEnabled può essere abilitata solo per i gruppi host creati come zona. Versione minima api: 2022-03-01. bool

TrackedResourceTags

Name Description Value

Esempi di utilizzo

Modelli di avvio rapido di Azure

I seguenti template Azure Quickstart distribuiscono questo tipo di risorsa.

Template Description
Host dedicati di Azure

Pubblica su Azure
Verrà distribuito un ambiente isolato usando host dedicati di Azure per il provisioning delle macchine virtuali.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa hostGroups può essere distribuito con operazioni destinate a:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/hostGroups, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/hostGroups@2025-11-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      additionalCapabilities = {
        ultraSSDEnabled = bool
      }
      platformFaultDomainCount = int
      supportAutomaticPlacement = bool
    }
    zones = [
      "string"
    ]
  }
}

Valori delle proprietà

Microsoft.Compute/hostGroups

Name Description Value
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa stringa (obbligatorio)
proprietà Proprietà del gruppo host dedicato. Proprietà del gruppo host dedicato
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft. Calcolo/hostGroups@2025-11-01"
zone Zone di disponibilità. string[]

Proprietà del gruppo host dedicato

Name Description Value
Funzionalità aggiuntive Abilita o disabilita una funzionalità nel gruppo host dedicato. Versione minima api: 2022-03-01. DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount Numero di domini di errore che il gruppo host può estendersi. int

Vincoli:
Valore minimo = 1 (obbligatorio)
di supportoAutomaticoPosizionamento Specifica se le macchine virtuali o i set di scalabilità di macchine virtuali possono essere posizionati automaticamente nel gruppo host dedicato. Il posizionamento automatico indica che le risorse vengono allocate in host dedicati, scelti da Azure, nel gruppo host dedicato. Il valore predefinito è 'false' se non specificato. Versione minima api: 2020-06-01. bool

DedicatedHostGroupPropertiesAdditionalCapabilities

Name Description Value
ultraSSDEnabled Flag che abilita o disabilita una funzionalità per cui è abilitato UltraSSD Macchine virtuali negli host dedicati del gruppo host dedicato. Affinché la Macchine virtuali sia abilitata per UltraSSD, anche il flag UltraSSDEnabled per la risorsa deve essere impostato su true. Il valore predefinito è 'false' se non specificato. Per altre informazioni sulla funzionalità Ultra SSD, vedere /azure/virtual-machines/disks-enable-ultra-ssd. Nota: L'impostazione ultraSSDEnabled può essere abilitata solo per i gruppi host creati come zona. Versione minima api: 2022-03-01. bool

TrackedResourceTags

Name Description Value

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione di un gruppo host dedicato.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "hostGroup" {
  type      = "Microsoft.Compute/hostGroups@2021-11-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      platformFaultDomainCount = 2
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Moduli verificati di Azure

I seguenti Azure Moduli Verificati possono essere utilizzati per distribuire questo tipo di risorsa.

Module Description
gruppi host Modulo di risorse AVM per i gruppi host