Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 2.5 KB

management_group.html.markdown

File metadata and controls

77 lines (51 loc) · 2.5 KB
Raw
subcategory layout page_title description
Management
azurerm
Azure Resource Manager: azurerm_management_group
Manages a Management Group.

azurerm_management_group

Manages a Management Group.

Example Usage

data "azurerm_subscription" "current" {
}

resource "azurerm_management_group" "example_parent" {
  display_name = "ParentGroup"

  subscription_ids = [
    data.azurerm_subscription.current.subscription_id,
  ]
}

resource "azurerm_management_group" "example_child" {
  display_name               = "ChildGroup"
  parent_management_group_id = azurerm_management_group.example_parent.id

  subscription_ids = [
    data.azurerm_subscription.current.subscription_id,
  ]
  # other subscription IDs can go here
}

Argument Reference

The following arguments are supported:

  • name - (Optional) The name or UUID for this Management Group, which needs to be unique across your tenant. A new UUID will be generated if not provided. Changing this forces a new resource to be created.

  • group_id - (Optional) The name or UUID for this Management Group, which needs to be unique across your tenant. A new UUID will be generated if not provided. Changing this forces a new resource to be created.

~> Note name and group_id here corresponds to ID on Azure Portal.

  • display_name - (Optional) A friendly name for this Management Group. If not specified, this'll be the same as the name.

~> Note display_name here corresponds to Name on Azure Portal.

  • parent_management_group_id - (Optional) The ID of the Parent Management Group. Changing this forces a new resource to be created.

  • subscription_ids - (Optional) A list of Subscription GUIDs which should be assigned to the Management Group.

Attributes Reference

The following attributes are exported:

  • id - The ID of the Management Group.

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

  • create - (Defaults to 30 minutes) Used when creating the Management Group.
  • update - (Defaults to 30 minutes) Used when updating the Management Group.
  • read - (Defaults to 5 minutes) Used when retrieving the Management Group.
  • delete - (Defaults to 30 minutes) Used when deleting the Management Group.

Import

Management Groups can be imported using the management group resource id, e.g.

terraform import azurerm_management_group.example /providers/Microsoft.Management/managementGroups/group1