Freigeben über

Databases - List Principals

Dienst:
Azure Kusto
API-Version:
2025-02-14

Gibt eine Liste der Datenbankprinzipale des angegebenen Kusto-Clusters und der Angegebenen Datenbank zurück.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/listPrincipals?api-version=2025-02-14

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
 path True

string

pattern: ^.*$

Der Name des Kusto-Clusters.
databaseName
 path True

string

pattern: ^.*$

Der Name der Datenbank im Kusto-Cluster.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string

minLength: 1

Hierbei handelt es sich um die ID des Zielabonnements.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

DatabasePrincipalListResult

Azure-Operation erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

KustoDatabaseListPrincipals

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
DatabasePrincipal

Eine Klasse, die die Datenbank-Hauptentität repräsentiert.
DatabasePrincipalListResult

Die Liste der Kusto-Datenbankprinzipien-Operation, Antwort.
DatabasePrincipalRole

Datenbankprinzipalrolle.
DatabasePrincipalType

Datenbankprinzipaltyp.
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort

DatabasePrincipal

Objekt

Eine Klasse, die die Datenbank-Hauptentität repräsentiert.

Name Typ Beschreibung
appId

string

Anwendungs-ID – relevant nur für den Typ des Anwendungsprinzipals.
email

string

Datenbank-Haupt-E-Mail, falls vorhanden.
fqn

string

Datenbankleiter voll qualifizierter Name.
name

string

Name des Datenbankprinzips.
role

DatabasePrincipalRole

Datenbankprinzipalrolle.
tenantName

string

Der Name des Mieters des Schulleiters
type

DatabasePrincipalType

Datenbankprinzipaltyp.

DatabasePrincipalListResult

Objekt

Die Liste der Kusto-Datenbankprinzipien-Operation, Antwort.

Name Typ Beschreibung
nextLink

string

Link zur nächsten Ergebnisseite.
value

DatabasePrincipal[]

Die Liste der Kusto-Datenbankprinzipale.

DatabasePrincipalRole

Enumeration

Datenbankprinzipalrolle.

Wert Beschreibung
Admin

Administrator
Ingestor

Ingestor
Monitor

Monitor
User

Benutzer
UnrestrictedViewer

UnrestrictedViewer
Viewer

Zuschauer

DatabasePrincipalType

Enumeration

Datenbankprinzipaltyp.

Wert Beschreibung
App

Anwendung
Group

Gruppieren
User

Benutzer

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.