# Role definition

Facts read 16 Nov 2026. Page reviewed 16 Nov 2026.

A role definition is the Azure object that lists the permissions a role allows. It names actions, data actions, exclusions and the scopes where the role can be assigned. Custom roles are written as role definitions, and built-in roles are published in the same form.

## An example, sourced

Microsoft's documentation lists the properties Actions, NotActions, DataActions, NotDataActions, AssignableScopes and Condition in a role definition, with dataActions covering operations on data in an object.

## Why it matters here

Reading the definition is the only reliable way to know what a role permits. Names such as Contributor can hide wide reach.

## Related pages

- [IAM Conditions: meaning and an example](/glossary/iam-conditions/)
- [Principal access boundary: meaning and an example](/glossary/principal-access-boundary/)
- [Deny policy: meaning and an example](/glossary/deny-policy/)
- [All of them](/glossary/)

## Sources

- https://learn.microsoft.com/en-us/azure/role-based-access-control/role-definitions (read 16 Nov 2026)

Last reviewed 16 Nov 2026. Canonical: https://leastprivilegeprinciple.com/glossary/role-definition/
