» azurerm_role_definition

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

» Example Usage

data "azurerm_subscription" "primary" {}

resource "azurerm_role_definition" "test" {
  role_definition_id = "12345678-1234-5678-1234-123456780123"
  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 - (Required) A unique UUID/GUID which identifies this role. 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.

» Import

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