Partager via


Microsoft.Compute hostGroupes/hôtes

Définition de ressource Bicep

Le type de ressource hostGroups/hosts peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/hostGroups/hosts, ajoutez le bicep suivant à votre modèle.

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'
  }
}

Valeurs de la propriété

Microsoft.Compute/hostGroups/hosts

Nom Descriptif Valeur
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : hostGroups
Propriétés Propriétés de l’hôte dédié. dedicatedHostProperties
Sku Référence SKU de l’hôte dédié pour la famille de machines virtuelles et de génération de matériel. Seul le nom doit être défini. Répertoriez les références SKU Microsoft.Compute pour obtenir la liste des valeurs possibles. référence SKU (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

DedicatedHostProperties

Nom Descriptif Valeur
autoReplaceOnFailure Spécifie si l’hôte dédié doit être remplacé automatiquement en cas de défaillance. La valeur est définie par défaut sur « true » lorsqu’elle n’est pas fournie. Bool
licenseType Spécifie le type de licence logicielle qui sera appliqué aux machines virtuelles déployées sur l’hôte dédié. Les valeurs possibles sont : None,Windows_Server_Hybrid,Windows_Server_Perpetual. La valeur par défaut est : None. « Aucun »
'Windows_Server_Hybrid'
'Windows_Server_Perpetual'
plateformeFaultDomain Domaine d’erreur de l’hôte dédié au sein d’un groupe hôte dédié. Int

Sku

Nom Descriptif Valeur
capacité Spécifie le nombre de machines virtuelles dans le groupe identique. Int
nom Nom de la référence SKU. corde
niveau Spécifie le niveau des machines virtuelles dans un groupe identique.

Valeurs possibles :

Standard

De base
corde

TrackedResourceTags

Nom Descriptif Valeur

Définition de ressource de modèle ARM

Le type de ressource hostGroups/hosts peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/hostGroups/hosts, ajoutez le code JSON suivant à votre modèle.

{
  "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"
  }
}

Valeurs de la propriété

Microsoft.Compute/hostGroups/hosts

Nom Descriptif Valeur
apiVersion Version de l’API '2025-04-01'
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés de l’hôte dédié. dedicatedHostProperties
Sku Référence SKU de l’hôte dédié pour la famille de machines virtuelles et de génération de matériel. Seul le nom doit être défini. Répertoriez les références SKU Microsoft.Compute pour obtenir la liste des valeurs possibles. référence SKU (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.Compute/hostGroups/hosts'

DedicatedHostProperties

Nom Descriptif Valeur
autoReplaceOnFailure Spécifie si l’hôte dédié doit être remplacé automatiquement en cas de défaillance. La valeur est définie par défaut sur « true » lorsqu’elle n’est pas fournie. Bool
licenseType Spécifie le type de licence logicielle qui sera appliqué aux machines virtuelles déployées sur l’hôte dédié. Les valeurs possibles sont : None,Windows_Server_Hybrid,Windows_Server_Perpetual. La valeur par défaut est : None. « Aucun »
'Windows_Server_Hybrid'
'Windows_Server_Perpetual'
plateformeFaultDomain Domaine d’erreur de l’hôte dédié au sein d’un groupe hôte dédié. Int

Sku

Nom Descriptif Valeur
capacité Spécifie le nombre de machines virtuelles dans le groupe identique. Int
nom Nom de la référence SKU. corde
niveau Spécifie le niveau des machines virtuelles dans un groupe identique.

Valeurs possibles :

Standard

De base
corde

TrackedResourceTags

Nom Descriptif Valeur

Exemples d’utilisation

Modèles de démarrage rapide Microsoft Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Modèle Descriptif
hôtes dédiés Azure

Déployer sur Azure
Cela déploie un environnement isolé à l’aide d’hôtes dédiés Azure pour vous permettre de provisionner des machines virtuelles.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource hostGroups/hosts peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/hostGroups/hosts, ajoutez le terraform suivant à votre modèle.

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"
    }
  }
}

Valeurs de la propriété

Microsoft.Compute/hostGroups/hosts

Nom Descriptif Valeur
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : hostGroups
Propriétés Propriétés de l’hôte dédié. dedicatedHostProperties
Sku Référence SKU de l’hôte dédié pour la famille de machines virtuelles et de génération de matériel. Seul le nom doit être défini. Répertoriez les références SKU Microsoft.Compute pour obtenir la liste des valeurs possibles. référence SKU (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Compute/hostGroups/hosts@2025-04-01 »

DedicatedHostProperties

Nom Descriptif Valeur
autoReplaceOnFailure Spécifie si l’hôte dédié doit être remplacé automatiquement en cas de défaillance. La valeur est définie par défaut sur « true » lorsqu’elle n’est pas fournie. Bool
licenseType Spécifie le type de licence logicielle qui sera appliqué aux machines virtuelles déployées sur l’hôte dédié. Les valeurs possibles sont : None,Windows_Server_Hybrid,Windows_Server_Perpetual. La valeur par défaut est : None. « Aucun »
'Windows_Server_Hybrid'
'Windows_Server_Perpetual'
plateformeFaultDomain Domaine d’erreur de l’hôte dédié au sein d’un groupe hôte dédié. Int

Sku

Nom Descriptif Valeur
capacité Spécifie le nombre de machines virtuelles dans le groupe identique. Int
nom Nom de la référence SKU. corde
niveau Spécifie le niveau des machines virtuelles dans un groupe identique.

Valeurs possibles :

Standard

De base
corde

TrackedResourceTags

Nom Descriptif Valeur

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement d’un hôte dédié au sein d’un groupe d’hôtes dédié.

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    = ["*"]
}