共用方式為

Microsoft.Compute hostGroups 2023-07-01

  • 發行項

Bicep 資源定義

hostGroups 資源類型可以使用目標作業進行部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.Compute/hostGroups 資源，請將下列 Bicep 新增至範本。

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

屬性值

hostGroups

名稱 描述 值
NAME 資源名稱 需要字串 ()
location 資源位置 需要字串 ()
tags 資源標籤 標記名稱和值的字典。 請參閱 範本中的標籤
properties 專用主機群組屬性。 DedicatedHostGroupProperties
zones (區域) 要用於此主機群組的可用性區域。 僅支援單一區域。 區域只能在建立期間指派。 如果未提供，群組支援該區域中的所有區域。 如果提供，則會強制群組中的每個主機位於相同區域中。 string[]

DedicatedHostGroupProperties

名稱 描述 值
additionalCapabilities 啟用或停用專用主機群組上的功能。 API 版本下限：2022-03-01。 DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount 主機群組可以跨越的容錯網域數目。 需要 int ()

約束：
最小值 = 1
supportAutomaticPlacement 指定是否可以將虛擬機或虛擬機擴展集自動放在專用主機群組上。 自動放置表示資源會配置在 Azure 在專用主機群組下的專用主機上。 未提供時，此值預設為 『false』。 API 版本下限：2020-06-01。 bool

DedicatedHostGroupPropertiesAdditionalCapabilities

名稱 描述 值
ultraSSDEnabled 旗標，可啟用或停用在專用主機群組的專用主機上啟用 UltraSSD 虛擬機器 的功能。 若要讓 虛擬機器 啟用 UltraSSD，也必須設定資源的 UltraSSDEnabled 旗標。 未提供時，此值預設為 『false』。 如需 Ultra SSD 功能的詳細資訊，請參閱 /azure/virtual-machines/disks-enable-Ultra-ssd。 注意： UltraSSDEnabled 設定只能針對建立為區域性的主機群組啟用。 API 版本下限：2022-03-01。 bool

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
Azure 專用主機

部署至 Azure		 這會使用 Azure 專用主機來部署隔離的環境，讓您布建 VM。

ARM 範本資源定義

hostGroups 資源類型可以使用目標作業進行部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.Compute/hostGroups 資源，請將下列 JSON 新增至您的範本。

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

屬性值

hostGroups

名稱 描述 值
類型 資源類型 'Microsoft.Compute/hostGroups'
apiVersion 資源 API 版本 '2023-07-01'
NAME 資源名稱 需要字串 ()
location 資源位置 需要字串 ()
tags 資源標籤 標記名稱和值的字典。 請參閱 範本中的標籤
properties 專用主機群組屬性。 DedicatedHostGroupProperties
zones (區域) 要用於此主機群組的可用性區域。 僅支援單一區域。 區域只能在建立期間指派。 如果未提供，群組支援該區域中的所有區域。 如果提供，則會強制群組中的每個主機位於相同區域中。 string[]

DedicatedHostGroupProperties

名稱 描述 值
additionalCapabilities 啟用或停用專用主機群組上的功能。 API 版本下限：2022-03-01。 DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount 主機群組可以跨越的容錯網域數目。 需要 int ()

約束：
最小值 = 1
supportAutomaticPlacement 指定是否可以將虛擬機或虛擬機擴展集自動放在專用主機群組上。 自動放置表示資源會配置在 Azure 在專用主機群組下的專用主機上。 未提供時，此值預設為 『false』。 API 版本下限：2020-06-01。 bool

DedicatedHostGroupPropertiesAdditionalCapabilities

名稱 描述 值
ultraSSDEnabled 旗標，可啟用或停用在專用主機群組的專用主機上啟用 UltraSSD 虛擬機器 的功能。 若要讓 虛擬機器 啟用 UltraSSD，也必須設定資源的 UltraSSDEnabled 旗標。 未提供時，此值預設為 『false』。 如需 Ultra SSD 功能的詳細資訊，請參閱 /azure/virtual-machines/disks-enable-Ultra-ssd。 注意： UltraSSDEnabled 設定只能針對建立為區域性的主機群組啟用。 API 版本下限：2022-03-01。 bool

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
Azure 專用主機

部署至 Azure		 這會使用 Azure 專用主機來部署隔離的環境，讓您布建 VM。

Terraform (AzAPI 提供者) 資源定義

hostGroups 資源類型可以使用目標作業進行部署：

  • 資源群組

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.Compute/hostGroups 資源，請將下列 Terraform 新增至範本。

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

屬性值

hostGroups

名稱 描述 值
類型 資源類型 “Microsoft.Compute/hostGroups@2023-07-01”
NAME 資源名稱 需要字串 ()
location 資源位置 需要字串 ()
parent_id 若要部署至資源群組，請使用該資源群組的標識碼。 需要字串 ()
tags 資源標籤 標記名稱和值的字典。
properties 專用主機群組屬性。 DedicatedHostGroupProperties
zones (區域) 要用於此主機群組的可用性區域。 僅支援單一區域。 區域只能在建立期間指派。 如果未提供，群組支援該區域中的所有區域。 如果提供，則會強制群組中的每個主機位於相同區域中。 string[]

DedicatedHostGroupProperties

名稱 描述 值
additionalCapabilities 啟用或停用專用主機群組上的功能。 API 版本下限：2022-03-01。 DedicatedHostGroupPropertiesAdditionalCapabilities
platformFaultDomainCount 主機群組可跨越的容錯網域數目。 int (必要)

約束：
最小值 = 1
supportAutomaticPlacement 指定虛擬機或虛擬機擴展集是否可以自動放在專用主機群組上。 自動放置表示資源會配置在專用主機上，而 Azure 會在專用主機群組下選擇。 未提供時，此值預設為 『false』。 API 版本下限：2020-06-01。 bool

DedicatedHostGroupPropertiesAdditionalCapabilities

名稱 描述 值
ultraSSDEnabled 旗標，可啟用或停用在專用主機群組的專用主機上啟用 UltraSSD 虛擬機器 的功能。 若要讓 虛擬機器 啟用 UltraSSD，也必須設定資源的 UltraSSDEnabled 旗標。 未提供時，此值預設為 『false』。 如需 Ultra SSD 功能的詳細資訊，請參閱 /azure/virtual-machines/disks-enable-ultra-ssd。 注意： UltraSSDEnabled 設定只能針對建立為區域性的主機群組啟用。 API 版本下限：2022-03-01。 bool