Udostępnij przez


Microsoft.Resources resourceGroups

Definicja zasobu Bicep

Typ zasobu resourceGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Resources/resourceGroups, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.Resources/resourceGroups

Nazwa Opis Wartość
lokalizacja Lokalizacja grupy zasobów. Nie można jej zmienić po utworzeniu grupy zasobów. Musi to być jedna z obsługiwanych lokalizacji platformy Azure. ciąg (wymagany)
zarządzanePrzez Identyfikator zasobu, który zarządza tą grupą zasobów. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 90
Wzorzec = ^[-\w\._\(\)]+$ (wymagane)
właściwości Właściwości grupy zasobów. Właściwości grupy zasobów
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
Etykiety Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

Właściwości grupy zasobów

Nazwa Opis Wartość

Tagi grupy zasobówResourceGroupTags

Nazwa Opis Wartość

Przykłady użycia

Przykłady Bicep

Podstawowy przykład wdrażania grupy zasobów.

targetScope = 'subscription'

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

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
Grupa Zasobów Moduł zasobów AVM dla grupy zasobów

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Konfigurowanie usługi środowiska wdrażania Ten szablon umożliwia konfigurowanie środowisk wdrażania.
Tworzenie nowej organizacji usługi Datadog Ten szablon tworzy nowy zasób usługi Datadog — natywna usługa niezależnego dostawcy oprogramowania platformy Azure i organizacja usługi Datadog do monitorowania zasobów w ramach subskrypcji.
Tworzenie grupy zasobów Ten szablon jest szablonem na poziomie subskrypcji, który utworzy grupę zasobów. Obecnie ten szablon można wdrożyć za pośrednictwem witryny Azure Portal.
Utwórz grupę zasobów, zastosuj blokadę i kontrolę dostępu opartą na rolach (RBAC) Ten szablon jest szablonem na poziomie subskrypcji, który utworzy grupę zasobów, zastosuje blokadę grupy zasobów i przypisz permsje współautora do podanego identyfikatora principalId. Obecnie nie można wdrożyć tego szablonu za pośrednictwem witryny Azure Portal.
Utwórz subskrypcję, grupę zasobów i storageAccount Ten szablon to szablon grupy zarządzania, który utworzy subskrypcję, grupę zasobów i konto magazynu w tym samym szablonie. Można go używać tylko w trybie rozliczeniowym umowy Enterprise Agreement. Oficjalna dokumentacja zawiera modyfikacje wymagane dla innych typów kont.
Tworzenie menedżera sieci wirtualnej platformy Azure i przykładowych sieci wirtualnych Ten szablon umożliwia wdrożenie menedżera sieci wirtualnej platformy Azure i przykładowych sieci wirtualnych w nazwanej grupie zasobów. Obsługuje wiele topologii łączności i typów członkostwa w grupach sieci.

Definicja zasobu szablonu usługi ARM

Typ zasobu resourceGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Resources/resourceGroups, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.Resources/resourceGroups

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2025-04-01'
lokalizacja Lokalizacja grupy zasobów. Nie można jej zmienić po utworzeniu grupy zasobów. Musi to być jedna z obsługiwanych lokalizacji platformy Azure. ciąg (wymagany)
zarządzanePrzez Identyfikator zasobu, który zarządza tą grupą zasobów. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 90
Wzorzec = ^[-\w\._\(\)]+$ (wymagane)
właściwości Właściwości grupy zasobów. Właściwości grupy zasobów
Etykiety Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.Resources/resourceGroups"

Właściwości grupy zasobów

Nazwa Opis Wartość

Tagi grupy zasobówResourceGroupTags

Nazwa Opis Wartość

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
Konfigurowanie usługi środowiska wdrażania

Wdrażanie na platformie Azure
Ten szablon umożliwia konfigurowanie środowisk wdrażania.
Tworzenie nowej organizacji usługi Datadog

Wdrażanie na platformie Azure
Ten szablon tworzy nowy zasób usługi Datadog — natywna usługa niezależnego dostawcy oprogramowania platformy Azure i organizacja usługi Datadog do monitorowania zasobów w ramach subskrypcji.
Tworzenie grupy zasobów

Wdrażanie na platformie Azure
Ten szablon jest szablonem na poziomie subskrypcji, który utworzy grupę zasobów. Obecnie ten szablon można wdrożyć za pośrednictwem witryny Azure Portal.
Utwórz grupę zasobów, zastosuj blokadę i kontrolę dostępu opartą na rolach (RBAC)

Wdrażanie na platformie Azure
Ten szablon jest szablonem na poziomie subskrypcji, który utworzy grupę zasobów, zastosuje blokadę grupy zasobów i przypisz permsje współautora do podanego identyfikatora principalId. Obecnie nie można wdrożyć tego szablonu za pośrednictwem witryny Azure Portal.
Utwórz subskrypcję, grupę zasobów i storageAccount

Wdrażanie na platformie Azure
Ten szablon to szablon grupy zarządzania, który utworzy subskrypcję, grupę zasobów i konto magazynu w tym samym szablonie. Można go używać tylko w trybie rozliczeniowym umowy Enterprise Agreement. Oficjalna dokumentacja zawiera modyfikacje wymagane dla innych typów kont.
Tworzenie menedżera sieci wirtualnej platformy Azure i przykładowych sieci wirtualnych

Wdrażanie na platformie Azure
Ten szablon umożliwia wdrożenie menedżera sieci wirtualnej platformy Azure i przykładowych sieci wirtualnych w nazwanej grupie zasobów. Obsługuje wiele topologii łączności i typów członkostwa w grupach sieci.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu resourceGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Resources/resourceGroups, dodaj następujący program Terraform do szablonu.

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 = {
    }
  }
}

Wartości właściwości

Microsoft.Resources/resourceGroups

Nazwa Opis Wartość
lokalizacja Lokalizacja grupy zasobów. Nie można jej zmienić po utworzeniu grupy zasobów. Musi to być jedna z obsługiwanych lokalizacji platformy Azure. ciąg (wymagany)
zarządzanePrzez Identyfikator zasobu, który zarządza tą grupą zasobów. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 90
Wzorzec = ^[-\w\._\(\)]+$ (wymagane)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
właściwości Właściwości grupy zasobów. Właściwości grupy zasobów
Etykiety Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Resources/resourceGroups@2025-04-01"

Właściwości grupy zasobów

Nazwa Opis Wartość

Tagi grupy zasobówResourceGroupTags

Nazwa Opis Wartość

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania grupy zasobów.

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
}

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
Grupa Zasobów Moduł zasobów AVM dla grupy zasobów