Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Définition de ressource Bicep
Le type de ressource hostGroups 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, ajoutez le bicep suivant à votre modèle.
resource symbolicname 'Microsoft.Compute/hostGroups@2025-04-01' = {
scope: resourceSymbolicName or scope
location: 'string'
name: 'string'
properties: {
additionalCapabilities: {
ultraSSDEnabled: bool
}
platformFaultDomainCount: int
supportAutomaticPlacement: bool
}
tags: {
{customized property}: 'string'
}
zones: [
'string'
]
}
Valeurs de propriété
Microsoft.Compute/hostGroups
| Nom | Descriptif | Valeur |
|---|---|---|
| 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 du groupe hôte dédié. | DedicatedHostGroupProperties |
| portée | Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. | Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension . |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
| Zones | Zones de disponibilité. | chaîne de caractères[] |
DedicatedHostGroupProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| additionalCapabilities | Active ou désactive une fonctionnalité sur le groupe hôte dédié. Version minimale de l’API : 2022-03-01. | DedicatedHostGroupPropertiesAdditionalCapabilities |
| platformFaultDomainCount | Nombre de domaines d’erreur que le groupe hôte peut étendre. | Int Contraintes: Valeur minimale = 1 (obligatoire) |
| supportAutomaticPlacement | Spécifie si les machines virtuelles ou les groupes de machines virtuelles identiques peuvent être placés automatiquement sur le groupe hôte dédié. Le placement automatique signifie que les ressources sont allouées sur des hôtes dédiés, choisis par Azure, sous le groupe hôte dédié. La valeur est définie par défaut sur « false » lorsqu’elle n’est pas fournie. Version minimale de l’API : 2020-06-01. | Bool |
DedicatedHostGroupPropertiesAdditionalCapabilities
| Nom | Descriptif | Valeur |
|---|---|---|
| UltraSSDEnabled | Indicateur qui active ou désactive une fonctionnalité pour que les machines virtuelles UltraSSD activées sur les hôtes dédiés du groupe hôte dédié puissent être activées. Pour que les machines virtuelles soient activées avec UltraSSD, l’indicateur UltraSSDEnabled pour la ressource doit également être défini sur true. La valeur est définie par défaut sur « false » lorsqu’elle n’est pas fournie. Pour plus d’informations sur la fonctionnalité Ssd Ultra, reportez-vous à /azure/virtual-machines/disks-enable-ultra-ssd. Remarque : le paramètre UltraSSDEnabled ne peut être activé que pour les groupes hôtes créés en tant que zonaux. Version minimale de l’API : 2022-03-01. | Bool |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
Définition de ressource de modèle ARM
Le type de ressource hostGroups 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, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.Compute/hostGroups",
"apiVersion": "2025-04-01",
"name": "string",
"location": "string",
"properties": {
"additionalCapabilities": {
"ultraSSDEnabled": "bool"
},
"platformFaultDomainCount": "int",
"supportAutomaticPlacement": "bool"
},
"tags": {
"{customized property}": "string"
},
"zones": [ "string" ]
}
Valeurs de propriété
Microsoft.Compute/hostGroups
| 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 du groupe hôte dédié. | DedicatedHostGroupProperties |
| é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' |
| Zones | Zones de disponibilité. | chaîne de caractères[] |
DedicatedHostGroupProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| additionalCapabilities | Active ou désactive une fonctionnalité sur le groupe hôte dédié. Version minimale de l’API : 2022-03-01. | DedicatedHostGroupPropertiesAdditionalCapabilities |
| platformFaultDomainCount | Nombre de domaines d’erreur que le groupe hôte peut étendre. | Int Contraintes: Valeur minimale = 1 (obligatoire) |
| supportAutomaticPlacement | Spécifie si les machines virtuelles ou les groupes de machines virtuelles identiques peuvent être placés automatiquement sur le groupe hôte dédié. Le placement automatique signifie que les ressources sont allouées sur des hôtes dédiés, choisis par Azure, sous le groupe hôte dédié. La valeur est définie par défaut sur « false » lorsqu’elle n’est pas fournie. Version minimale de l’API : 2020-06-01. | Bool |
DedicatedHostGroupPropertiesAdditionalCapabilities
| Nom | Descriptif | Valeur |
|---|---|---|
| UltraSSDEnabled | Indicateur qui active ou désactive une fonctionnalité pour que les machines virtuelles UltraSSD activées sur les hôtes dédiés du groupe hôte dédié puissent être activées. Pour que les machines virtuelles soient activées avec UltraSSD, l’indicateur UltraSSDEnabled pour la ressource doit également être défini sur true. La valeur est définie par défaut sur « false » lorsqu’elle n’est pas fournie. Pour plus d’informations sur la fonctionnalité Ssd Ultra, reportez-vous à /azure/virtual-machines/disks-enable-ultra-ssd. Remarque : le paramètre UltraSSDEnabled ne peut être activé que pour les groupes hôtes créés en tant que zonaux. Version minimale de l’API : 2022-03-01. | Bool |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
Exemples d’utilisation
Modèles de démarrage rapide 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 |
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 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, ajoutez terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/hostGroups@2025-04-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
additionalCapabilities = {
ultraSSDEnabled = bool
}
platformFaultDomainCount = int
supportAutomaticPlacement = bool
}
zones = [
"string"
]
}
}
Valeurs de propriété
Microsoft.Compute/hostGroups
| 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 à laquelle appliquer cette ressource d’extension. | chaîne (obligatoire) |
| Propriétés | Propriétés du groupe hôte dédié. | DedicatedHostGroupProperties |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. |
| type | Type de ressource | « Microsoft.Compute/hostGroups@2025-04-01 » |
| Zones | Zones de disponibilité. | chaîne de caractères[] |
DedicatedHostGroupProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| additionalCapabilities | Active ou désactive une fonctionnalité sur le groupe hôte dédié. Version minimale de l’API : 2022-03-01. | DedicatedHostGroupPropertiesAdditionalCapabilities |
| platformFaultDomainCount | Nombre de domaines d’erreur que le groupe hôte peut étendre. | Int Contraintes: Valeur minimale = 1 (obligatoire) |
| supportAutomaticPlacement | Spécifie si les machines virtuelles ou les groupes de machines virtuelles identiques peuvent être placés automatiquement sur le groupe hôte dédié. Le placement automatique signifie que les ressources sont allouées sur des hôtes dédiés, choisis par Azure, sous le groupe hôte dédié. La valeur est définie par défaut sur « false » lorsqu’elle n’est pas fournie. Version minimale de l’API : 2020-06-01. | Bool |
DedicatedHostGroupPropertiesAdditionalCapabilities
| Nom | Descriptif | Valeur |
|---|---|---|
| UltraSSDEnabled | Indicateur qui active ou désactive une fonctionnalité pour que les machines virtuelles UltraSSD activées sur les hôtes dédiés du groupe hôte dédié puissent être activées. Pour que les machines virtuelles soient activées avec UltraSSD, l’indicateur UltraSSDEnabled pour la ressource doit également être défini sur true. La valeur est définie par défaut sur « false » lorsqu’elle n’est pas fournie. Pour plus d’informations sur la fonctionnalité Ssd Ultra, reportez-vous à /azure/virtual-machines/disks-enable-ultra-ssd. Remarque : le paramètre UltraSSDEnabled ne peut être activé que pour les groupes hôtes créés en tant que zonaux. Version minimale de l’API : 2022-03-01. | Bool |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
Exemples d’utilisation
Échantillons Terraform
Exemple de base de déploiement 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 = ["*"]
}
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Descriptif |
|---|---|
| groupes hôtes | Module de ressources AVM pour les groupes hôtes |