Partager via

Microsoft.Compute hostGroups 2024-07-01

  • 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 de ressource

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

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

Valeurs de propriété

hostGroups

Nom Description Valeur
nom Nom de la ressource chaîne (obligatoire)
emplacement Emplacement des ressources chaîne (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Propriétés Propriétés du groupe hôte dédié. DedicatedHostGroupProperties
zones Zone de disponibilité à utiliser pour ce groupe hôte. Seule une seule zone est prise en charge. La zone ne peut être attribuée qu’au moment 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. Tableau de zones de disponibilité sous forme de chaîne ou d’int.

DedicatedHostGroupProperties

Nom Description 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 (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, 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 Description 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

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 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 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": "2024-07-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "additionalCapabilities": {
      "ultraSSDEnabled": "bool"
    },
    "platformFaultDomainCount": "int",
    "supportAutomaticPlacement": "bool"
  },
  "zones": [ "string" or int ]
}

Valeurs de propriété

hostGroups

Nom Description Valeur
type Type de ressource 'Microsoft.Compute/hostGroups'
apiVersion Version de l’API de ressource '2024-07-01'
nom Nom de la ressource chaîne (obligatoire)
emplacement Emplacement des ressources chaîne (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Propriétés Propriétés du groupe hôte dédié. DedicatedHostGroupProperties
zones Zone de disponibilité à utiliser pour ce groupe hôte. Seule une seule zone est prise en charge. La zone ne peut être attribuée qu’au moment 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. Tableau de zones de disponibilité sous forme de chaîne ou d’int.

DedicatedHostGroupProperties

Nom Description 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 (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, 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 Description 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

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 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 :

  • groupes de ressources

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@2024-07-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" or int
    ]
  })
}

Valeurs de propriété

hostGroups

Nom Description Valeur
type Type de ressource « Microsoft.Compute/hostGroups@2024-07-01 »
nom Nom de la ressource chaîne (obligatoire)
emplacement Emplacement des ressources 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)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
Propriétés Propriétés du groupe hôte dédié. DedicatedHostGroupProperties
zones Zone de disponibilité à utiliser pour ce groupe hôte. Seule une seule zone est prise en charge. La zone ne peut être attribuée qu’au moment 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. Tableau de zones de disponibilité sous forme de chaîne ou d’int.

DedicatedHostGroupProperties

Nom Description 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 (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, 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 Description 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