Role Definitions - Get
Obter definição de função por nome (GUID).
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId}?api-version=2022-04-01
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
role
|
path | True |
string |
A ID da definição de função. |
|
scope
|
path | True |
string |
O escopo da definição de função. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OK - Retorna informações sobre a definição de função. |
|
| Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | representar sua conta de usuário |
Exemplos
Get role definition by name
Solicitação de exemplo
Resposta de exemplo
{
"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"
}
Definições
| Nome | Description |
|---|---|
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
| Permission |
Permissões de definição de função. |
|
Role |
Definição de função. |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
Permission
Permissões de definição de função.
| Nome | Tipo | Description |
|---|---|---|
| actions |
string[] |
Ações permitidas. |
| dataActions |
string[] |
Ações de dados permitidas. |
| notActions |
string[] |
Ações negadas. |
| notDataActions |
string[] |
Ações de dados negadas. |
RoleDefinition
Definição de função.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
A ID da definição de função. |
| name |
string |
O nome da definição da função. |
| properties.assignableScopes |
string[] |
Escopos atribuíveis à definição de função. |
| properties.createdBy |
string |
ID do usuário que criou a atribuição |
| properties.createdOn |
string (date-time) |
Hora em que foi criado |
| properties.description |
string |
A descrição da definição de função. |
| properties.permissions |
Permissões de definição de função. |
|
| properties.roleName |
string |
O nome da função. |
| properties.type |
string |
O tipo de função. |
| properties.updatedBy |
string |
ID do usuário que atualizou a atribuição |
| properties.updatedOn |
string (date-time) |
Hora em que foi atualizado |
| type |
string |
O tipo de definição de função. |