Udostępnij za pośrednictwem


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 identyfikatora URI

Nazwa W Wymagane Typ Opis
scope
path True

string

Zakres definicji roli.

api-version
query True

string

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 OAuth2 usługi Azure Active Directory

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

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

List role definitions for scope

Przykładowe żądanie

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 przez definicję roli.

properties.createdBy

string

Identyfikator użytkownika, który utworzył przypisanie

properties.createdOn

string

Czas jego 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

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