Role Definitions - Get
Pobierz definicję roli według nazwy (GUID).
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId}?api-version=2022-04-01
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
role
|
path | True |
string |
Identyfikator definicji roli. |
|
scope
|
path | True |
string |
Zakres definicji roli. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK — zwraca informacje o definicji roli. |
|
| Other Status Codes |
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
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
Get role definition by name
Przykładowe żądanie
Przykładowa odpowiedź
{
"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 |
|---|---|
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
| Permission |
Uprawnienia definicji roli. |
|
Role |
Definicja 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 |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
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 |
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 |
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. |