Role Assignments - List For Scope
Gets role assignments for a scope.
GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=7.4
GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?$filter={$filter}&api-version=7.4
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
scope
|
path | True |
string |
The scope of the role assignments. |
vault
|
path | True |
string |
The vault name, for example https://myvault.vault.azure.net. |
api-version
|
query | True |
string |
Client API version. |
$filter
|
query |
string |
The filter to apply on the operation. Use $filter=atScope() to return all role assignments at or above the scope. Use $filter=principalId eq {id} to return all role assignments at, above or below the scope for the specified principal. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK - Returns an array of role assignments. |
|
Other Status Codes |
Key Vault error response describing why the operation failed. |
Examples
ListRoleAssignments
Sample request
GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments?api-version=7.4
Sample response
{
"value": [
{
"properties": {
"roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
"principalId": "principalId",
"scope": "/keys"
},
"id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
"type": "Microsoft.Authorization/roleAssignments",
"name": "roleAssignmentId"
}
]
}
Definitions
Name | Description |
---|---|
Error |
The key vault server error. |
Key |
The key vault error exception. |
Role |
Role Assignments |
Role |
Role assignment list operation result. |
Role |
Role assignment properties with scope. |
Role |
The role scope. |
Error
The key vault server error.
Name | Type | Description |
---|---|---|
code |
string |
The error code. |
innererror |
The key vault server error. |
|
message |
string |
The error message. |
KeyVaultError
The key vault error exception.
Name | Type | Description |
---|---|---|
error |
The key vault server error. |
RoleAssignment
Role Assignments
Name | Type | Description |
---|---|---|
id |
string |
The role assignment ID. |
name |
string |
The role assignment name. |
properties |
Role assignment properties. |
|
type |
string |
The role assignment type. |
RoleAssignmentListResult
Role assignment list operation result.
Name | Type | Description |
---|---|---|
nextLink |
string |
The URL to use for getting the next set of results. |
value |
Role assignment list. |
RoleAssignmentPropertiesWithScope
Role assignment properties with scope.
Name | Type | Description |
---|---|---|
principalId |
string |
The principal ID. |
roleDefinitionId |
string |
The role definition ID. |
scope |
The role scope. |
RoleScope
The role scope.
Name | Type | Description |
---|---|---|
/ |
string |
Global scope |
/keys |
string |
Keys scope |