Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Definição de recursos do bíceps
O tipo de recurso resourceGroups pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Resources/resourceGroups, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.Resources/resourceGroups@2025-04-01' = {
scope: resourceSymbolicName or scope
location: 'string'
managedBy: 'string'
name: 'string'
properties: {}
tags: {
{customized property}: 'string'
}
}
Valores de propriedade
Microsoft.Resources/resourceGroups
| Nome | Descrição | Valor |
|---|---|---|
| localização | O local do grupo de recursos. Ele não pode ser alterado após a criação do grupo de recursos. Tem de ser uma das localizações do Azure suportadas. | string (obrigatório) |
| gerenciado por | A ID do recurso que gerencia esse grupo de recursos. | cadeia (de caracteres) |
| nome | O nome do recurso | cadeia de caracteres Restrições: Comprimento mínimo = 1 Comprimento máximo = 90 Padrão = ^[-\w\._\(\)]+$ (obrigatório) |
| propriedades | As propriedades do grupo de recursos. | ResourceGroupProperties |
| âmbito | Use ao criar um recurso em um escopo diferente do escopo de implantação. | Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão . |
| etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
ResourceGroupProperties
| Nome | Descrição | Valor |
|---|
ResourceGroupTags
| Nome | Descrição | Valor |
|---|
Exemplos de uso
Amostras de bíceps
Um exemplo básico de implantação de um grupo de recursos.
targetScope = 'subscription'
resource rg 'Microsoft.Resources/resourceGroups@2021-04-01' = {
name: 'myResourceGroup'
location: deployment().location
tags: {
environment: 'production'
}
}
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
| Módulo | Descrição |
|---|---|
| Grupo de Recursos | Módulo de recursos AVM para grupo de recursos |
Exemplos de início rápido do Azure
Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.
| Arquivo Bicep | Descrição |
|---|---|
| de serviço Configurar Ambientes de Implantação | Este modelo fornece uma maneira de configurar ambientes de implantação. |
| Criar uma nova organização Datadog | Este modelo cria um novo Datadog - Um recurso de Serviço ISV Nativo do Azure e uma organização Datadog para monitorar recursos em sua assinatura. |
| Criar um resourceGroup | Este modelo é um modelo de nível de assinatura que criará um resourceGroup. Atualmente, esse modelo pode ser implantado por meio do Portal do Azure. |
| Criar um grupo de recursos, aplicar um bloqueio e Controle de Acesso Baseado em Funções (RBAC) | Este modelo é um modelo de nível de assinatura que criará um resourceGroup, aplicará um bloqueio ao resourceGroup e atribuirá permssions de contribuidor ao principalId fornecido. Atualmente, esse modelo não pode ser implantado por meio do Portal do Azure. |
| Criar uma assinatura, resourceGroup e storageAccount | Este modelo é um modelo de grupo de gerenciamento que criará uma assinatura, um resourceGroup e uma storageAccount no mesmo modelo. Ele pode ser usado apenas para um modo de faturamento do Enterprise Agreement. A documentação oficial mostra modificações necessárias para outros tipos de contas. |
| Criar um Gerenciador de Rede Virtual do Azure e exemplos de VNETs | Este modelo implanta um Gerenciador de Rede Virtual do Azure e redes virtuais de exemplo no grupo de recursos nomeado. Ele suporta várias topologias de conectividade e tipos de associação de grupo de rede. |
Definição de recurso de modelo ARM
O tipo de recurso resourceGroups pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Resources/resourceGroups, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.Resources/resourceGroups",
"apiVersion": "2025-04-01",
"name": "string",
"location": "string",
"managedBy": "string",
"properties": {
},
"tags": {
"{customized property}": "string"
}
}
Valores de propriedade
Microsoft.Resources/resourceGroups
| Nome | Descrição | Valor |
|---|---|---|
| Versão da API | A versão api | '2025-04-01' |
| localização | O local do grupo de recursos. Ele não pode ser alterado após a criação do grupo de recursos. Tem de ser uma das localizações do Azure suportadas. | string (obrigatório) |
| gerenciado por | A ID do recurso que gerencia esse grupo de recursos. | cadeia (de caracteres) |
| nome | O nome do recurso | cadeia de caracteres Restrições: Comprimento mínimo = 1 Comprimento máximo = 90 Padrão = ^[-\w\._\(\)]+$ (obrigatório) |
| propriedades | As propriedades do grupo de recursos. | ResourceGroupProperties |
| etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
| tipo | O tipo de recurso | 'Microsoft.Resources/resourceGroups' |
ResourceGroupProperties
| Nome | Descrição | Valor |
|---|
ResourceGroupTags
| Nome | Descrição | Valor |
|---|
Exemplos de uso
Modelos de início rápido do Azure
Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.
| Modelo | Descrição |
|---|---|
|
de serviço Configurar Ambientes de Implantação |
Este modelo fornece uma maneira de configurar ambientes de implantação. |
|
Criar uma nova organização Datadog |
Este modelo cria um novo Datadog - Um recurso de Serviço ISV Nativo do Azure e uma organização Datadog para monitorar recursos em sua assinatura. |
|
Criar um resourceGroup |
Este modelo é um modelo de nível de assinatura que criará um resourceGroup. Atualmente, esse modelo pode ser implantado por meio do Portal do Azure. |
|
Criar um grupo de recursos, aplicar um bloqueio e Controle de Acesso Baseado em Funções (RBAC) |
Este modelo é um modelo de nível de assinatura que criará um resourceGroup, aplicará um bloqueio ao resourceGroup e atribuirá permssions de contribuidor ao principalId fornecido. Atualmente, esse modelo não pode ser implantado por meio do Portal do Azure. |
|
Criar uma assinatura, resourceGroup e storageAccount |
Este modelo é um modelo de grupo de gerenciamento que criará uma assinatura, um resourceGroup e uma storageAccount no mesmo modelo. Ele pode ser usado apenas para um modo de faturamento do Enterprise Agreement. A documentação oficial mostra modificações necessárias para outros tipos de contas. |
|
Criar um Gerenciador de Rede Virtual do Azure e exemplos de VNETs |
Este modelo implanta um Gerenciador de Rede Virtual do Azure e redes virtuais de exemplo no grupo de recursos nomeado. Ele suporta várias topologias de conectividade e tipos de associação de grupo de rede. |
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso resourceGroups pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Resources/resourceGroups, adicione o seguinte Terraform ao seu modelo.
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 = {
}
}
}
Valores de propriedade
Microsoft.Resources/resourceGroups
| Nome | Descrição | Valor |
|---|---|---|
| localização | O local do grupo de recursos. Ele não pode ser alterado após a criação do grupo de recursos. Tem de ser uma das localizações do Azure suportadas. | string (obrigatório) |
| gerenciado por | A ID do recurso que gerencia esse grupo de recursos. | cadeia (de caracteres) |
| nome | O nome do recurso | cadeia de caracteres Restrições: Comprimento mínimo = 1 Comprimento máximo = 90 Padrão = ^[-\w\._\(\)]+$ (obrigatório) |
| parent_id | A ID do recurso ao qual aplicar esse recurso de extensão. | string (obrigatório) |
| propriedades | As propriedades do grupo de recursos. | ResourceGroupProperties |
| etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. |
| tipo | O tipo de recurso | "Microsoft.Resources/resourceGroups@2025-04-01" |
ResourceGroupProperties
| Nome | Descrição | Valor |
|---|
ResourceGroupTags
| Nome | Descrição | Valor |
|---|
Exemplos de uso
Amostras Terraform
Um exemplo básico de implantação do Grupo de Recursos.
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
}
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
| Módulo | Descrição |
|---|---|
| Grupo de Recursos | Módulo de recursos AVM para grupo de recursos |