Condividi tramite


HostGroups/hosts Microsoft.Compute

Definizione di risorsa Bicep

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

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

Formato risorsa

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

resource symbolicname 'Microsoft.Compute/hostGroups/hosts@2025-04-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    autoReplaceOnFailure: bool
    licenseType: 'string'
    platformFaultDomain: int
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft.Compute/hostGroups/hosts

Nome Descrizione Valore
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.
Nome simbolico per la risorsa di tipo: hostGroups
proprietà Proprietà dell'host dedicato. Proprietà HostDedicate
Sku SKU dell'host dedicato per la generazione hardware e la famiglia di macchine virtuali. È necessario impostare solo il nome. Elencare gli SKU Microsoft.Compute per un elenco di valori possibili. sku (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

Proprietà HostDedicate

Nome Descrizione Valore
autoReplaceOnFailure Specifica se l'host dedicato deve essere sostituito automaticamente in caso di errore. Il valore predefinito è "true" se non specificato. Bool
tipo di licenza Specifica il tipo di licenza software che verrà applicato alle macchine virtuali distribuite nell'host dedicato. I valori possibili sono: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Il valore predefinito è: Nessuno. 'Nessuno'
'Windows_Server_Hybrid'
'Windows_Server_Perpetual'
platformFaultDomain Dominio di errore dell'host dedicato all'interno di un gruppo host dedicato. Int

Sku

Nome Descrizione Valore
capacità Specifica il numero di macchine virtuali nel set di scalabilità. Int
nome Nome sku. corda
livello Specifica il livello di macchine virtuali in un set di scalabilità.

Valori possibili:

Standard

Base
corda

TrackedResourceTags

Nome Descrizione Valore

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione di un host dedicato all'interno di un gruppo di 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
  }
}

resource host 'Microsoft.Compute/hostGroups/hosts@2021-11-01' = {
  parent: hostGroup
  name: resourceName
  location: location
  properties: {
    autoReplaceOnFailure: true
    licenseType: 'None'
    platformFaultDomain: 1
  }
  sku: {
    name: 'DSv3-Type1'
  }
}

Definizione di risorsa del modello di Resource Manager

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

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

Formato risorsa

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

{
  "type": "Microsoft.Compute/hostGroups/hosts",
  "apiVersion": "2025-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "autoReplaceOnFailure": "bool",
    "licenseType": "string",
    "platformFaultDomain": "int"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft.Compute/hostGroups/hosts

Nome Descrizione Valore
versione dell'API Versione dell'API '2025-04-01'
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà dell'host dedicato. Proprietà HostDedicate
Sku SKU dell'host dedicato per la generazione hardware e la famiglia di macchine virtuali. È necessario impostare solo il nome. Elencare gli SKU Microsoft.Compute per un elenco di valori possibili. sku (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.Compute/hostGroups/hosts'

Proprietà HostDedicate

Nome Descrizione Valore
autoReplaceOnFailure Specifica se l'host dedicato deve essere sostituito automaticamente in caso di errore. Il valore predefinito è "true" se non specificato. Bool
tipo di licenza Specifica il tipo di licenza software che verrà applicato alle macchine virtuali distribuite nell'host dedicato. I valori possibili sono: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Il valore predefinito è: Nessuno. 'Nessuno'
'Windows_Server_Hybrid'
'Windows_Server_Perpetual'
platformFaultDomain Dominio di errore dell'host dedicato all'interno di un gruppo host dedicato. Int

Sku

Nome Descrizione Valore
capacità Specifica il numero di macchine virtuali nel set di scalabilità. Int
nome Nome sku. corda
livello Specifica il livello di macchine virtuali in un set di scalabilità.

Valori possibili:

Standard

Base
corda

TrackedResourceTags

Nome Descrizione Valore

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
host dedicati di Azure

Distribuire in 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/hosts 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 risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/hostGroups/hosts@2025-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      autoReplaceOnFailure = bool
      licenseType = "string"
      platformFaultDomain = int
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Compute/hostGroups/hosts

Nome Descrizione Valore
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: hostGroups
proprietà Proprietà dell'host dedicato. Proprietà HostDedicate
Sku SKU dell'host dedicato per la generazione hardware e la famiglia di macchine virtuali. È necessario impostare solo il nome. Elencare gli SKU Microsoft.Compute per un elenco di valori possibili. sku (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.Compute/hostGroups/hosts@2025-04-01"

Proprietà HostDedicate

Nome Descrizione Valore
autoReplaceOnFailure Specifica se l'host dedicato deve essere sostituito automaticamente in caso di errore. Il valore predefinito è "true" se non specificato. Bool
tipo di licenza Specifica il tipo di licenza software che verrà applicato alle macchine virtuali distribuite nell'host dedicato. I valori possibili sono: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Il valore predefinito è: Nessuno. 'Nessuno'
'Windows_Server_Hybrid'
'Windows_Server_Perpetual'
platformFaultDomain Dominio di errore dell'host dedicato all'interno di un gruppo host dedicato. Int

Sku

Nome Descrizione Valore
capacità Specifica il numero di macchine virtuali nel set di scalabilità. Int
nome Nome sku. corda
livello Specifica il livello di macchine virtuali in un set di scalabilità.

Valori possibili:

Standard

Base
corda

TrackedResourceTags

Nome Descrizione Valore

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione di un host dedicato all'interno di un gruppo di 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    = ["*"]
}

resource "azapi_resource" "host" {
  type      = "Microsoft.Compute/hostGroups/hosts@2021-11-01"
  parent_id = azapi_resource.hostGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      autoReplaceOnFailure = true
      licenseType          = "None"
      platformFaultDomain  = 1
    }
    sku = {
      name = "DSv3-Type1"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}