Compartir a través de


ResourceGroups de Microsoft.Resources

Definición de recursos de Bicep

El tipo de recurso resourceGroups se puede implementar con operaciones que tienen como destino:

  • de suscripción de : consulte comandos de implementación de suscripciones de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Resources/resourceGroups, agregue lo siguiente a la plantilla de Bicep.

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

Ejemplos

Ejemplo básico de implementación de un grupo de recursos.

targetScope = 'subscription'

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

Valores de propiedad

Microsoft.Resources/resourceGroups

Nombre Descripción Valor
ubicación Ubicación del grupo de recursos. No se puede cambiar una vez creado el grupo de recursos. Debe ser una de las ubicaciones de Azure admitidas. string (obligatorio)
managedBy Identificador del recurso que administra este grupo de recursos. cuerda
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 1
Patrón = ^[-\w\._\(\)]+$ (obligatorio)
Propiedades Propiedades del grupo de recursos. ResourceGroupProperties
Etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ResourceGroupProperties

Nombre Descripción Valor

ResourceGroupTags

Nombre Descripción Valor

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
Configurar entornos de implementación Esta plantilla proporciona una manera de configurar entornos de implementación.
Crear una nueva organización de Datadog Esta plantilla crea un nuevo recurso de Datadog: un recurso del servicio ISV nativo de Azure y una organización de Datadog para supervisar los recursos de la suscripción.
Crear un resourceGroup Esta plantilla es una plantilla de nivel de suscripción que creará un resourceGroup. Actualmente, esta plantilla se puede implementar a través de Azure Portal.
Crear un grupo de recursos, aplicar un bloqueo y un RBAC Esta plantilla es una plantilla de nivel de suscripción que creará un resourceGroup, aplicará un bloqueo al resourceGroup y asignará permsiones de colaborador al principalId proporcionado. Actualmente, esta plantilla no se puede implementar a través de Azure Portal.
Crear una suscripción, resourceGroup y storageAccount Esta plantilla es una plantilla de grupo de administración que creará una suscripción, un resourceGroup y un storageAccount en la misma plantilla. Solo se puede usar para un modo de facturación del Contrato Enterprise. La documentación oficial muestra las modificaciones necesarias para otros tipos de cuentas.
Creación de una instancia de Azure Virtual Network Manager y redes virtuales de ejemplo Esta plantilla implementa una instancia de Azure Virtual Network Manager y de ejemplo de redes virtuales en el grupo de recursos con nombre. Admite varias topologías de conectividad y tipos de pertenencia a grupos de red.

Definición de recursos de plantilla de ARM

El tipo de recurso resourceGroups se puede implementar con operaciones que tienen como destino:

  • de suscripción de : consulte comandos de implementación de suscripciones de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Resources/resourceGroups, agregue el siguiente json a la plantilla.

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

Valores de propiedad

Microsoft.Resources/resourceGroups

Nombre Descripción Valor
apiVersion La versión de api '2024-11-01'
ubicación Ubicación del grupo de recursos. No se puede cambiar una vez creado el grupo de recursos. Debe ser una de las ubicaciones de Azure admitidas. string (obligatorio)
managedBy Identificador del recurso que administra este grupo de recursos. cuerda
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 1
Patrón = ^[-\w\._\(\)]+$ (obligatorio)
Propiedades Propiedades del grupo de recursos. ResourceGroupProperties
Etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.Resources/resourceGroups"

ResourceGroupProperties

Nombre Descripción Valor

ResourceGroupTags

Nombre Descripción Valor

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Configurar entornos de implementación

Implementación en Azure
Esta plantilla proporciona una manera de configurar entornos de implementación.
Crear una nueva organización de Datadog

Implementación en Azure
Esta plantilla crea un nuevo recurso de Datadog: un recurso del servicio ISV nativo de Azure y una organización de Datadog para supervisar los recursos de la suscripción.
Crear un resourceGroup

Implementación en Azure
Esta plantilla es una plantilla de nivel de suscripción que creará un resourceGroup. Actualmente, esta plantilla se puede implementar a través de Azure Portal.
Crear un grupo de recursos, aplicar un bloqueo y un RBAC

Implementación en Azure
Esta plantilla es una plantilla de nivel de suscripción que creará un resourceGroup, aplicará un bloqueo al resourceGroup y asignará permsiones de colaborador al principalId proporcionado. Actualmente, esta plantilla no se puede implementar a través de Azure Portal.
Crear una suscripción, resourceGroup y storageAccount

Implementación en Azure
Esta plantilla es una plantilla de grupo de administración que creará una suscripción, un resourceGroup y un storageAccount en la misma plantilla. Solo se puede usar para un modo de facturación del Contrato Enterprise. La documentación oficial muestra las modificaciones necesarias para otros tipos de cuentas.
Creación de una instancia de Azure Virtual Network Manager y redes virtuales de ejemplo

Implementación en Azure
Esta plantilla implementa una instancia de Azure Virtual Network Manager y de ejemplo de redes virtuales en el grupo de recursos con nombre. Admite varias topologías de conectividad y tipos de pertenencia a grupos de red.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso resourceGroups se puede implementar con operaciones que tienen como destino:

  • de suscripción

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Resources/resourceGroups, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/resourceGroups@2024-11-01"
  name = "string"
  location = "string"
  managedBy = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
    }
  })
}

Valores de propiedad

Microsoft.Resources/resourceGroups

Nombre Descripción Valor
ubicación Ubicación del grupo de recursos. No se puede cambiar una vez creado el grupo de recursos. Debe ser una de las ubicaciones de Azure admitidas. string (obligatorio)
managedBy Identificador del recurso que administra este grupo de recursos. cuerda
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 1
Patrón = ^[-\w\._\(\)]+$ (obligatorio)
Propiedades Propiedades del grupo de recursos. ResourceGroupProperties
Etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.Resources/resourceGroups@2024-11-01"

ResourceGroupProperties

Nombre Descripción Valor

ResourceGroupTags

Nombre Descripción Valor