Compartilhar via


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
roleDefinitionId
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

RoleDefinition

OK – retorna informações sobre a definição de função.

Other Status Codes

ErrorResponse

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

GET https://management.azure.com/scope/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId?api-version=2022-04-01

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
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

Os detalhes do erro.

ErrorResponse

Resposta de erro

Permission

Permissões de definição de função.

RoleDefinition

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

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

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

Permission[]

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.