Udostępnij przez


Role Definitions - List

Pobierz wszystkie definicje ról, które mają zastosowanie w zakresie i powyżej.

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

Parametry URI

Nazwa W Wymagane Typ Opis
scope
path True

string

Zakres definicji roli.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

$filter
query

string

Filtr do zastosowania w operacji. Użyj filtru atScopeAndBelow, aby wyszukać pod podanym zakresem.

Odpowiedzi

Nazwa Typ Opis
200 OK

RoleDefinitionListResult

OK — zwraca tablicę definicji ról.

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

List role definitions for scope

Przykładowa prośba

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

Permission

Uprawnienia definicji roli.

RoleDefinition

Definicja roli.

RoleDefinitionListResult

Wynik operacji listy definicji roli.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

Permission

Uprawnienia definicji roli.

Nazwa Typ Opis
actions

string[]

Dozwolone akcje.

dataActions

string[]

Dozwolone akcje danych.

notActions

string[]

Odrzucone akcje.

notDataActions

string[]

Odrzucone akcje danych.

RoleDefinition

Definicja roli.

Nazwa Typ Opis
id

string

Identyfikator definicji roli.

name

string

Nazwa definicji roli.

properties.assignableScopes

string[]

Zakresy przypisywane do definicji roli.

properties.createdBy

string

Identyfikator użytkownika, który utworzył przypisanie

properties.createdOn

string (date-time)

Godzina utworzenia

properties.description

string

Opis definicji roli.

properties.permissions

Permission[]

Uprawnienia definicji roli.

properties.roleName

string

Nazwa roli.

properties.type

string

Typ roli.

properties.updatedBy

string

Identyfikator użytkownika, który zaktualizował przypisanie

properties.updatedOn

string (date-time)

Czas jego aktualizacji

type

string

Typ definicji roli.

RoleDefinitionListResult

Wynik operacji listy definicji roli.

Nazwa Typ Opis
nextLink

string

Adres URL używany do pobierania następnego zestawu wyników.

value

RoleDefinition[]

Lista definicji ról.