Manages a custom Role Definition, used to assign Roles to Users/Principals.

Example Usage

data "azurerm_subscription" "primary" {}

resource "azurerm_role_definition" "test" {
  name               = "my-custom-role"
  scope              = "${data.azurerm_subscription.primary.id}"
  description        = "This is a custom role created via Terraform"

  permissions {
    actions     = ["*"]
    not_actions = []

  assignable_scopes = [
    "${data.azurerm_subscription.primary.id}", # /subscriptions/00000000-0000-0000-0000-000000000000

Argument Reference

The following arguments are supported:

  • role_definition_id - (Optional) A unique UUID/GUID which identifies this role - one will be generated if not specified. Changing this forces a new resource to be created.

  • name - (Required) The name of the Role Definition. Changing this forces a new resource to be created.

  • scope - (Required) The scope at which the Role Definition applies too, such as /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup, or /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM. Changing this forces a new resource to be created.

  • description - (Optional) A description of the Role Definition.

  • permissions - (Required) A permissions block as defined below.

  • assignable_scopes - (Required) One or more assignable scopes for this Role Definition, such as /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup, or /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM.

A permissions block as the following properties:

  • action - (Optional) One or more Allowed Actions, such as *, Microsoft.Resources/subscriptions/resourceGroups/read.

  • not_action - (Optional) One or more Disallowed Actions, such as *, Microsoft.Resources/subscriptions/resourceGroups/read.

Attributes Reference

The following attributes are exported:

  • id - The Role Definition ID.


Role Definitions can be imported using the resource id, e.g.

terraform import azurerm_role_definition.test /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000

© 2018 HashiCorpLicensed under the MPL 2.0 License.