Partager via


Groupes de ressources Microsoft.Resources

Définition de ressource Bicep

Le type de ressource resourceGroups peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Resources/resourceGroups, ajoutez le bicep suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Resources/resourceGroups

Nom Descriptif Valeur
lieu Emplacement du groupe de ressources. Elle ne peut pas être modifiée une fois le groupe de ressources créé. Il doit s’agir de l’un des emplacements Azure pris en charge. chaîne (obligatoire)
managedBy ID de la ressource qui gère ce groupe de ressources. ficelle
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 90
Modèle = ^[-\w\._\(\)]+$ (obligatoire)
Propriétés Propriétés du groupe de ressources. ResourceGroupProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ResourceGroupProperties

Nom Descriptif Valeur

ResourceGroupTags

Nom Descriptif Valeur

Exemples d’utilisation

Exemples Bicep

Exemple de base de déploiement d’un groupe de ressources.

targetScope = 'subscription'

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

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
Groupe de ressources Module de ressources AVM pour le groupe de ressources

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Descriptif
configurer le service Environnements de déploiement Ce modèle permet de configurer des environnements de déploiement.
Créer une organisation Datadog Ce modèle crée une ressource Datadog - Une ressource azure ISV Service et une organisation Datadog pour surveiller les ressources de votre abonnement.
Créer un groupe de ressources Ce modèle est un modèle de niveau abonnement qui crée un groupe de ressources. Actuellement, ce modèle peut être déployé via le portail Azure.
Créer un groupe de ressources, appliquer un verrou et un contrôle d’accès en fonction du rôle Ce modèle est un modèle de niveau abonnement qui crée un groupe de ressources, applique un verrou au groupe de ressources et affecte des permssions contributeurs au principalId fourni. Actuellement, ce modèle ne peut pas être déployé via le portail Azure.
Créer un abonnement, un groupe de ressources et un compte de stockage Ce modèle est un modèle de groupe d’administration qui crée un abonnement, un groupe de ressources et un storageAccount dans le même modèle. Il peut être utilisé uniquement pour un mode de facturation Contrat Entreprise. La documentation officielle présente les modifications nécessaires pour d’autres types de comptes.
créer un gestionnaire de réseaux virtuels Azure et des exemples de réseaux virtuels Ce modèle déploie un Gestionnaire de réseaux virtuels Azure et des exemples de réseaux virtuels dans le groupe de ressources nommé. Il prend en charge plusieurs topologies de connectivité et types d’appartenance au groupe réseau.

Définition de ressource de modèle ARM

Le type de ressource resourceGroups peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Resources/resourceGroups, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Resources/resourceGroups

Nom Descriptif Valeur
apiVersion Version de l’API '2025-04-01'
lieu Emplacement du groupe de ressources. Elle ne peut pas être modifiée une fois le groupe de ressources créé. Il doit s’agir de l’un des emplacements Azure pris en charge. chaîne (obligatoire)
managedBy ID de la ressource qui gère ce groupe de ressources. ficelle
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 90
Modèle = ^[-\w\._\(\)]+$ (obligatoire)
Propriétés Propriétés du groupe de ressources. ResourceGroupProperties
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.Resources/resourceGroups'

ResourceGroupProperties

Nom Descriptif Valeur

ResourceGroupTags

Nom Descriptif Valeur

Exemples d’utilisation

Modèles de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Modèle Descriptif
configurer le service Environnements de déploiement

Déployer sur Azure
Ce modèle permet de configurer des environnements de déploiement.
Créer une organisation Datadog

Déployer sur Azure
Ce modèle crée une ressource Datadog - Une ressource azure ISV Service et une organisation Datadog pour surveiller les ressources de votre abonnement.
Créer un groupe de ressources

Déployer sur Azure
Ce modèle est un modèle de niveau abonnement qui crée un groupe de ressources. Actuellement, ce modèle peut être déployé via le portail Azure.
Créer un groupe de ressources, appliquer un verrou et un contrôle d’accès en fonction du rôle

Déployer sur Azure
Ce modèle est un modèle de niveau abonnement qui crée un groupe de ressources, applique un verrou au groupe de ressources et affecte des permssions contributeurs au principalId fourni. Actuellement, ce modèle ne peut pas être déployé via le portail Azure.
Créer un abonnement, un groupe de ressources et un compte de stockage

Déployer sur Azure
Ce modèle est un modèle de groupe d’administration qui crée un abonnement, un groupe de ressources et un storageAccount dans le même modèle. Il peut être utilisé uniquement pour un mode de facturation Contrat Entreprise. La documentation officielle présente les modifications nécessaires pour d’autres types de comptes.
créer un gestionnaire de réseaux virtuels Azure et des exemples de réseaux virtuels

Déployer sur Azure
Ce modèle déploie un Gestionnaire de réseaux virtuels Azure et des exemples de réseaux virtuels dans le groupe de ressources nommé. Il prend en charge plusieurs topologies de connectivité et types d’appartenance au groupe réseau.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource resourceGroups peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Resources/resourceGroups, ajoutez terraform suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Resources/resourceGroups

Nom Descriptif Valeur
lieu Emplacement du groupe de ressources. Elle ne peut pas être modifiée une fois le groupe de ressources créé. Il doit s’agir de l’un des emplacements Azure pris en charge. chaîne (obligatoire)
managedBy ID de la ressource qui gère ce groupe de ressources. ficelle
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 90
Modèle = ^[-\w\._\(\)]+$ (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés du groupe de ressources. ResourceGroupProperties
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Resources/resourceGroups@2025-04-01 »

ResourceGroupProperties

Nom Descriptif Valeur

ResourceGroupTags

Nom Descriptif Valeur

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement d’un groupe de ressources.

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
}

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
Groupe de ressources Module de ressources AVM pour le groupe de ressources