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
clusterName
path True

string

pattern: ^.*$

Nazwa klastra Kusto.

databaseName
path True

string

pattern: ^.*$

Nazwa bazy danych w klastrze Kusto.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
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

DatabasePrincipalListResult

Operacja Azure zakończyła się pomyślnie.

Other Status Codes

ErrorResponse

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
DatabasePrincipal

Klasa reprezentująca główną jednostkę bazy danych.

DatabasePrincipalListResult

Lista odpowiedzi na operacje z zasadami bazy danych Kusto.

DatabasePrincipalRole

Rola główna bazy danych.

DatabasePrincipalType

Typ głównej bazy danych.

ErrorAdditionalInfo

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

ErrorDetail

Szczegóły błędu.

ErrorResponse

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.

email

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

DatabasePrincipalRole

Rola główna bazy danych.

tenantName

string

Nazwisko najemcy dyrektora

type

DatabasePrincipalType

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

DatabasePrincipal[]

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

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

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwisko Typ Opis
error

ErrorDetail

Obiekt błędu.