Microsoft.Resources 資源群組

Bicep 資源定義

resourceGroups 資源類型可以使用目標作業來部署:

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

使用範例

Bicep 範例

部署資源群組的基本範例。

targetScope = 'subscription'

resource rg 'Microsoft.Resources/resourceGroups@2021-04-01' = {
  name: 'myResourceGroup'
  location: deployment().location
  tags: {
    environment: 'production'
  }
}

部署資源群組的基本範例。

targetScope = 'subscription'

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource resourceGroup 'Microsoft.Resources/resourceGroups@2020-06-01' = {
  name: resourceName
  location: location
}

Azure 已驗證的模組

下列 Azure 驗證模組 可用來部署此資源類型。

模組 說明
資源群組 資源群組的AVM資源模組

Azure 快速入門範例

下列 Azure 快速入門範本 包含用於部署此資源類型的 Bicep 範例。

Bicep 檔案 說明
設定部署環境服務 此範本提供設定部署環境的方式。
建立新的Datadog組織 此範本會建立新的 Datadog - Azure 原生 ISV 服務資源和 Datadog 組織,以監視訂用帳戶中的資源。
建立 resourceGroup 此範本是將建立 resourceGroup 的訂用帳戶層級範本。 此範本目前可透過 Azure 入口網站進行部署。
建立 resourceGroup、套用鎖定和 RBAC 此範本是訂用帳戶層級範本,會建立 resourceGroup、套用資源群組的鎖定,並將參與者分派給提供的 principalId。 目前無法透過 Azure 入口網站部署此範本。
建立訂用帳戶、resourceGroup 和 storageAccount 此範本是管理群組範本,將在同一個範本中建立訂用帳戶、resourceGroup 和 storageAccount。 它只能用於 Enterprise 合約計費模式。 官方文件顯示其他類型的帳戶所需的修改。
建立 Azure 虛擬網路管理員和範例 VNET 此範本會將 Azure 虛擬網路管理員和範例虛擬網路部署到具名資源群組中。 它支援多個連線拓撲和網路群組成員資格類型。
Deploy private 金鑰保存庫 for Azure Enclave workload 本範例部署私有 Azure Key Vault,採用訂閱範圍,並支援私有端點網路及可選的 Azure Enclave 工作負載關聯。

資源格式

若要建立 Microsoft.Resources/resourceGroups 資源,請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.Resources/resourceGroups@2025-04-01' = {
  location: 'string'
  managedBy: 'string'
  name: 'string'
  properties: {}
  tags: {
    {customized property}: 'string'
  }
}

屬性值

Microsoft.Resources/resourceGroups

名稱 說明 價值觀
位置 資源所在的地理位置 字串 (必要)
managedBy 管理此資源群組之資源的標識碼。 字串
名稱 資源名稱 字串

約束:
最小長度 = 1
最大長度 = 90
模式 = ^[-\w\._\(\)]+$ (必要)
屬性 資源群組屬性。 ResourceGroupProperties
標記 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤

ResourceGroupProperties

名稱 說明 價值觀

TrackedResourceTags

名稱 說明 價值觀

ARM 樣本資源定義

resourceGroups 資源類型可以使用目標作業來部署:

使用範例

Azure 快速入門範本

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

範本 說明
設定部署環境服務

部署至 Azure
此範本提供設定部署環境的方式。
建立新的Datadog組織

部署至 Azure
此範本會建立新的 Datadog - Azure 原生 ISV 服務資源和 Datadog 組織,以監視訂用帳戶中的資源。
建立 resourceGroup

部署至 Azure
此範本是將建立 resourceGroup 的訂用帳戶層級範本。 此範本目前可透過 Azure 入口網站進行部署。
建立 resourceGroup、套用鎖定和 RBAC

部署至 Azure
此範本是訂用帳戶層級範本,會建立 resourceGroup、套用資源群組的鎖定,並將參與者分派給提供的 principalId。 目前無法透過 Azure 入口網站部署此範本。
建立訂用帳戶、resourceGroup 和 storageAccount

部署至 Azure
此範本是管理群組範本,將在同一個範本中建立訂用帳戶、resourceGroup 和 storageAccount。 它只能用於 Enterprise 合約計費模式。 官方文件顯示其他類型的帳戶所需的修改。
建立 Azure 虛擬網路管理員和範例 VNET

部署至 Azure
此範本會將 Azure 虛擬網路管理員和範例虛擬網路部署到具名資源群組中。 它支援多個連線拓撲和網路群組成員資格類型。
Deploy private 金鑰保存庫 for Azure Enclave workload

部署至 Azure
本範例部署私有 Azure Key Vault,採用訂閱範圍,並支援私有端點網路及可選的 Azure Enclave 工作負載關聯。

資源格式

若要建立 Microsoft.Resources/resourceGroups 資源,請將下列 JSON 新增至範本。

{
  "type": "Microsoft.Resources/resourceGroups",
  "apiVersion": "2025-04-01",
  "name": "string",
  "location": "string",
  "managedBy": "string",
  "properties": {
  },
  "tags": {
    "{customized property}": "string"
  }
}

屬性值

Microsoft.Resources/resourceGroups

名稱 說明 價值觀
apiVersion API 版本 '2025-04-01'
位置 資源所在的地理位置 字串 (必要)
managedBy 管理此資源群組之資源的標識碼。 字串
名稱 資源名稱 字串

約束:
最小長度 = 1
最大長度 = 90
模式 = ^[-\w\._\(\)]+$ (必要)
屬性 資源群組屬性。 ResourceGroupProperties
標記 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
型別 資源類型 'Microsoft.Resources/resourceGroups'

ResourceGroupProperties

名稱 說明 價值觀

TrackedResourceTags

名稱 說明 價值觀

Terraform (AzAPI 提供者) 資源定義

resourceGroups 資源類型可以使用目標作業來部署:

  • 訂閱 關於每個 API 版本變更屬性的清單,請參見 變更日誌。

使用範例

Terraform 範例

部署資源群組的基本範例。

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
}

Azure 已驗證的模組

下列 Azure 驗證模組 可用來部署此資源類型。

模組 說明
資源群組 資源群組的AVM資源模組

資源格式

若要建立 Microsoft.Resources/resourceGroups 資源,請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/resourceGroups@2025-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    managedBy = "string"
    properties = {
    }
  }
}

屬性值

Microsoft.Resources/resourceGroups

名稱 說明 價值觀
位置 資源所在的地理位置 字串 (必要)
managedBy 管理此資源群組之資源的標識碼。 字串
名稱 資源名稱 字串

約束:
最小長度 = 1
最大長度 = 90
模式 = ^[-\w\._\(\)]+$ (必要)
屬性 資源群組屬性。 ResourceGroupProperties
標記 資源標籤 標記名稱和值的字典。
型別 資源類型 “Microsoft.資源/resourceGroups@2025-04-01”

ResourceGroupProperties

名稱 說明 價值觀

TrackedResourceTags

名稱 說明 價值觀