Partilhar 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 do URI

Name Em Necessário Tipo Description
roleDefinitionId
path True

string

A ID da definição de função.

scope
path True

string

O âmbito da definição de funções.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Respostas

Name Tipo Description
200 OK

RoleDefinition

OK - Retorna informações sobre a definição de função.

Other Status Codes

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Get role definition by name

Pedido de amostra

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

Resposta da amostra

{
  "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

Name Description
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

Permission

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

RoleDefinition

Definição de funções.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

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

Name Tipo Description
error

ErrorDetail

O objeto de erro.

Permission

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

Name Tipo Description
actions

string[]

Ações permitidas.

dataActions

string[]

Ações de dados permitidos.

notActions

string[]

Ações negadas.

notDataActions

string[]

Ações de dados negados.

RoleDefinition

Definição de funções.

Name Tipo Description
id

string

O ID de definição de função.

name

string

O nome da definição de função.

properties.assignableScopes

string[]

Escopos atribuíveis de definição de função.

properties.createdBy

string

ID do usuário que criou a atribuição

properties.createdOn

string (date-time)

Tempo 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 (date-time)

Hora em que foi atualizado

type

string

O tipo de definição de função.