github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/azurerm/r/resource_group.html.markdown (about)

     1  ---
     2  layout: "azurerm"
     3  page_title: "Azure Resource Manager: azurerm_resource_group"
     4  sidebar_current: "docs-azurerm-resource-resource-group"
     5  description: |-
     6      Creates a new resource group on Azure.
     7  ---
     8  
     9  # azurerm\_resource\_group
    10  
    11  Creates a new resource group on Azure.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "azurerm_resource_group" "test" {
    17    name     = "testResourceGroup1"
    18    location = "West US"
    19  
    20    tags {
    21      environment = "Production"
    22    }
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `name` - (Required) The name of the resource group. Must be unique on your
    31      Azure subscription.
    32  
    33  * `location` - (Required) The location where the resource group should be created.
    34      For a list of all Azure locations, please consult [this link](http://azure.microsoft.com/en-us/regions/).
    35  
    36  * `tags` - (Optional) A mapping of tags to assign to the resource.
    37  
    38  ## Attributes Reference
    39  
    40  The following attributes are exported:
    41  
    42  * `id` - The resource group ID.
    43  
    44  
    45  ## Import
    46  
    47  Resource Groups can be imported using the `resource id`, e.g.
    48  
    49  ```
    50  terraform import azurerm_resource_group.mygroup /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup
    51  ```