Partager via

Microsoft.Compute hostGroups

  • Article

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 des ressources

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

resource symbolicname 'Microsoft.Compute/hostGroups@2023-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    additionalCapabilities: {
      ultraSSDEnabled: bool
    }
    platformFaultDomainCount: int
    supportAutomaticPlacement: bool
  }
  zones: [
    'string'
  ]
}

Valeurs de propriétés

hostGroups

Nom Description Valeur
name Nom de la ressource chaîne (obligatoire)
location Emplacement de la ressource chaîne (obligatoire)
tags Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
properties Propriétés du groupe hôte dédié. DedicatedHostGroupProperties
zones Zone de disponibilité à utiliser pour ce groupe hôte. Une seule zone est prise en charge. La zone ne peut être affectée que lors de la création. S’il n’est pas fourni, le groupe prend en charge toutes les zones de la région. S’il est fourni, applique chaque hôte du groupe à se trouver dans la même zone. string[]

DedicatedHostGroupProperties

Nom Description Valeur
additionalCapabilities Active ou désactive une fonctionnalité sur le groupe hôte dédié. Version minimale de l’api : 01/03/2022. DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount Nombre de domaines d’erreur que le groupe hôte peut couvrir. int (obligatoire)

Contraintes :
Valeur minimale = 1
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, qui sont choisis par Azure, sous le groupe hôte dédié. La valeur par défaut est « false » lorsqu’elle n’est pas fournie. Version minimale de l’api : 01/06/2020. bool

DedicatedHostGroupPropertiesAdditionalCapabilities

Nom Description Valeur
ultraSSDEnabled Indicateur qui active ou désactive une capacité à avoir UltraSSD activé Machines Virtuelles sur les hôtes dédiés du groupe hôte dédié. Pour que la Machines Virtuelles soit activée pour UltraSSD, l’indicateur UltraSSDEnabled de la ressource doit également être défini sur true. La valeur par défaut est « false » lorsqu’elle n’est pas fournie. Pour plus d’informations sur la fonctionnalité SSD Ultra, consultez /azure/virtual-machines/disks-enable-ultra-ssd. Note: 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 : 01/03/2022. bool

Modèles de démarrage rapide

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

Modèle Description
Hôtes dédiés Azure

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

Définition de ressources 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 des ressources

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

{
  "type": "Microsoft.Compute/hostGroups",
  "apiVersion": "2023-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "additionalCapabilities": {
      "ultraSSDEnabled": "bool"
    },
    "platformFaultDomainCount": "int",
    "supportAutomaticPlacement": "bool"
  },
  "zones": [ "string" ]
}

Valeurs de propriétés

hostGroups

Nom Description Valeur
type Type de ressource « Microsoft.Compute/hostGroups »
apiVersion Version de l’API de ressource '2023-09-01'
name Nom de la ressource chaîne (obligatoire)
location Emplacement de la ressource chaîne (obligatoire)
tags Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
properties Propriétés du groupe hôte dédié. DedicatedHostGroupProperties
zones Zone de disponibilité à utiliser pour ce groupe hôte. Une seule zone est prise en charge. La zone ne peut être affectée que lors de la création. S’il n’est pas fourni, le groupe prend en charge toutes les zones de la région. S’il est fourni, applique chaque hôte du groupe à se trouver dans la même zone. string[]

DedicatedHostGroupProperties

Nom Description Valeur
additionalCapabilities Active ou désactive une fonctionnalité sur le groupe hôte dédié. Version minimale de l’api : 01/03/2022. DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount Nombre de domaines d’erreur que le groupe hôte peut couvrir. int (obligatoire)

Contraintes :
Valeur minimale = 1
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, qui sont choisis par Azure, sous le groupe hôte dédié. La valeur par défaut est « false » lorsqu’elle n’est pas fournie. Version minimale de l’api : 01/06/2020. bool

DedicatedHostGroupPropertiesAdditionalCapabilities

Nom Description Valeur
ultraSSDEnabled Indicateur qui active ou désactive une capacité à avoir UltraSSD activé Machines Virtuelles sur les hôtes dédiés du groupe hôte dédié. Pour que la Machines Virtuelles soit activée pour UltraSSD, l’indicateur UltraSSDEnabled de la ressource doit également être défini sur true. La valeur par défaut est « false » lorsqu’elle n’est pas fournie. Pour plus d’informations sur la fonctionnalité SSD Ultra, consultez /azure/virtual-machines/disks-enable-ultra-ssd. Note: 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 : 01/03/2022. bool

Modèles de démarrage rapide

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

Modèle Description
Hôtes dédiés Azure

Déployer sur Azure		 Cela permet de déployer un environnement isolé à l’aide d’hôtes dédiés Azure pour vous permettre d’approvisionner 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 :

  • Groupes de ressources

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

Format des ressources

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/hostGroups@2023-09-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"
    ]
  })
}

Valeurs de propriétés

hostGroups

Nom Description Valeur
type Type de ressource « Microsoft.Compute/hostGroups@2023-09-01 »
name Nom de la ressource chaîne (obligatoire)
location Emplacement de la ressource chaîne (obligatoire)
parent_id Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. chaîne (obligatoire)
tags Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
properties Propriétés du groupe hôte dédié. DedicatedHostGroupProperties
zones Zone de disponibilité à utiliser pour ce groupe hôte. Une seule zone est prise en charge. La zone ne peut être affectée que lors de la création. S’il n’est pas fourni, le groupe prend en charge toutes les zones de la région. S’il est fourni, applique chaque hôte du groupe à se trouver dans la même zone. string[]

DedicatedHostGroupProperties

Nom Description Valeur
additionalCapabilities Active ou désactive une fonctionnalité sur le groupe hôte dédié. Version minimale de l’api : 01/03/2022. DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount Nombre de domaines d’erreur que le groupe hôte peut couvrir. int (obligatoire)

Contraintes :
Valeur minimale = 1
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, qui sont choisis par Azure, sous le groupe hôte dédié. La valeur par défaut est « false » lorsqu’elle n’est pas fournie. Version minimale de l’api : 01/06/2020. bool

DedicatedHostGroupPropertiesAdditionalCapabilities

Nom Description Valeur
ultraSSDEnabled Indicateur qui active ou désactive une capacité à avoir UltraSSD activé Machines Virtuelles sur les hôtes dédiés du groupe hôte dédié. Pour que la Machines Virtuelles soit activée pour UltraSSD, l’indicateur UltraSSDEnabled de la ressource doit également être défini sur true. La valeur par défaut est « false » lorsqu’elle n’est pas fournie. Pour plus d’informations sur la fonctionnalité SSD Ultra, consultez /azure/virtual-machines/disks-enable-ultra-ssd. Note: 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 : 01/03/2022. bool