Role Definitions - Delete
Deletes a role definition.
DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId}?api-version=2022-04-01
Name | In | Required | Type | Description |
---|---|---|---|---|
role
|
path | True |
string |
The ID of the role definition to delete. |
scope
|
path | True |
string |
The scope of the role definition. |
api-version
|
query | True |
string |
The API version to use for this operation. |
Name | Type | Description |
---|---|---|
200 OK |
OK - Returns information about the role definition. |
|
204 No Content |
Role definition already deleted or does not exist. |
|
Other Status Codes |
Error response describing why the operation failed. |
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Sample request
Sample response
{
"properties": {
"roleName": "Role name",
"type": "roletype",
"description": "Role description",
"assignableScopes": [
"/subscriptions/subId"
],
"permissions": [
{
"actions": [
"action"
],
"notActions": [],
"dataActions": [
"dataAction"
],
"notDataActions": []
}
]
},
"id": "/subscriptions/subID/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
"type": "Microsoft.Authorization/roleDefinitions",
"name": "roleDefinitionId"
}
Name | Description |
---|---|
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Permission |
Role definition permissions. |
Role |
Role definition. |
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
Role definition permissions.
Name | Type | Description |
---|---|---|
actions |
string[] |
Allowed actions. |
dataActions |
string[] |
Allowed Data actions. |
notActions |
string[] |
Denied actions. |
notDataActions |
string[] |
Denied Data actions. |
Role definition.
Name | Type | Description |
---|---|---|
id |
string |
The role definition ID. |
name |
string |
The role definition name. |
properties.assignableScopes |
string[] |
Role definition assignable scopes. |
properties.createdBy |
string |
Id of the user who created the assignment |
properties.createdOn |
string |
Time it was created |
properties.description |
string |
The role definition description. |
properties.permissions |
Role definition permissions. |
|
properties.roleName |
string |
The role name. |
properties.type |
string |
The role type. |
properties.updatedBy |
string |
Id of the user who updated the assignment |
properties.updatedOn |
string |
Time it was updated |
type |
string |
The role definition type. |