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 |
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 do 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 |
Os detalhes 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
Os detalhes 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 de definição de função. |
name |
string |
O nome da definição de 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 |
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 |
Hora em que foi atualizado |
type |
string |
O tipo de definição de função. |