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

Name In Required Type 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

Name Type 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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Get role definition by name

Sample Request

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

Sample Response

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

ErrorAdditionalInfo

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

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

Permission

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

RoleDefinition

Definição da função.

ErrorAdditionalInfo

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

Name Type Description
info
  • object

As informações adicionais.

type
  • string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Type 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

Name Type Description
error

O objeto de erro.

Permission

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

Name Type 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 da função.

Name Type Description
id
  • string

A ID de 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.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.

type
  • string

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