Partilhar via


Role Definitions - List

Obtenha todas as definições de função aplicáveis no âmbito e acima.

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?api-version=2022-04-01
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?$filter={$filter}&api-version=2022-04-01

Parâmetros do URI

Name Em Necessário Tipo Description
scope
path True

string

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

api-version
query True

string

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

$filter
query

string

O filtro a aplicar na operação. Utilize também o filtro atScopeAndBelow para procurar abaixo do âmbito especificado.

Respostas

Name Tipo Description
200 OK

RoleDefinitionListResult

OK - Devolve uma matriz de definições de função.

Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

List role definitions for scope

Pedido de amostra

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

Resposta da amostra

{
  "value": [
    {
      "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

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

Permission

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

RoleDefinition

Definição de função.

RoleDefinitionListResult

Resultado da operação da lista de definições de função.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name 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 a erros

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 Permitidas.

notActions

string[]

Ações negadas.

notDataActions

string[]

Ações de Dados Negados.

RoleDefinition

Definição de função.

Name Tipo Description
id

string

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

name

string

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

properties.assignableScopes

string[]

Âmbitos atribuíveis da definição de função.

properties.createdBy

string

ID do utilizador que criou a atribuição

properties.createdOn

string

Hora de criação

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 utilizador que atualizou a atribuição

properties.updatedOn

string

Hora em que foi atualizado

type

string

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

RoleDefinitionListResult

Resultado da operação da lista de definições de função.

Name Tipo Description
nextLink

string

O URL a utilizar para obter o próximo conjunto de resultados.

value

RoleDefinition[]

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