Databases - List Principals
Zwraca listę podmiotów zabezpieczeń bazy danych danego klastra i bazy danych Kusto.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/listPrincipals?api-version=2025-02-14
Parametry identyfikatora URI
| Nazwisko | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
cluster
|
path | True |
string pattern: ^.*$ |
Nazwa klastra Kusto. |
|
database
|
path | True |
string pattern: ^.*$ |
Nazwa bazy danych w klastrze Kusto. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string minLength: 1 |
Identyfikator subskrypcji docelowej. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Odpowiedzi
| Nazwisko | Typ | Opis |
|---|---|---|
| 200 OK |
Operacja Azure zakończyła się pomyślnie. |
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
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
| Nazwisko | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
KustoDatabaseListPrincipals
Przykładowe żądanie
POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster/databases/KustoDatabase8/listPrincipals?api-version=2025-02-14
Przykładowa odpowiedź
{
"value": [
{
"name": "Some User",
"type": "User",
"appId": "",
"email": "user@microsoft.com",
"fqn": "aaduser=some_guid",
"role": "Admin"
},
{
"name": "Kusto",
"type": "Group",
"appId": "",
"email": "kusto@microsoft.com",
"fqn": "aadgroup=some_guid",
"role": "Viewer"
},
{
"name": "SomeApp",
"type": "App",
"appId": "some_guid_app_id",
"email": "",
"fqn": "aadapp=some_guid_app_id",
"role": "Admin"
}
]
}
Definicje
| Nazwisko | Opis |
|---|---|
|
Database |
Klasa reprezentująca główną jednostkę bazy danych. |
|
Database |
Lista odpowiedzi na operacje z zasadami bazy danych Kusto. |
|
Database |
Rola główna bazy danych. |
|
Database |
Typ głównej bazy danych. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
DatabasePrincipal
Klasa reprezentująca główną jednostkę bazy danych.
| Nazwisko | Typ | Opis |
|---|---|---|
| appId |
string |
ID aplikacji – dotyczy tylko typu głównego zastosowania. |
|
string |
Główny adres e-mail bazy danych, jeśli istnieje. |
|
| fqn |
string |
Dyrektor bazy danych – w pełni kwalifikowane imię. |
| name |
string |
Główna nazwa bazy danych. |
| role |
Rola główna bazy danych. |
|
| tenantName |
string |
Nazwisko najemcy dyrektora |
| type |
Typ głównej bazy danych. |
DatabasePrincipalListResult
Lista odpowiedzi na operacje z zasadami bazy danych Kusto.
| Nazwisko | Typ | Opis |
|---|---|---|
| nextLink |
string |
Link do następnej strony z wynikami. |
| value |
Lista podmiotów zabezpieczeń bazy danych Kusto. |
DatabasePrincipalRole
Rola główna bazy danych.
| Wartość | Opis |
|---|---|
| Admin |
Administrator |
| Ingestor |
Ingestor |
| Monitor |
Monitor |
| User |
Użytkownik |
| UnrestrictedViewer |
UnrestrictedViewer |
| Viewer |
Przeglądarka |
DatabasePrincipalType
Typ głównej bazy danych.
| Wartość | Opis |
|---|---|
| App |
Aplikacja |
| Group |
Grupa |
| User |
Użytkownik |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwisko | Typ | Opis |
|---|---|---|
| info |
object |
Dodatkowe informacje. |
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwisko | 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 |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwisko | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |