Freigeben über


Databases - List Principals

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=2023-08-15

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
path True

string

Der Name des Kusto-Clusters.

RegEx-Muster: ^.*$

databaseName
path True

string

Der Name der Datenbank im Kusto-Cluster.

RegEx-Muster: ^.*$

resourceGroupName
path True

string

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

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

DatabasePrincipalListResult

Die Liste der Datenbankprinzipale wurde erfolgreich abgerufen.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

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=2023-08-15

Beispiel für eine Antwort

{
  "value": [
    {
      "name": "Some User",
      "role": "Admin",
      "type": "User",
      "fqn": "aaduser=some_guid",
      "email": "user@microsoft.com",
      "appId": ""
    },
    {
      "name": "Kusto",
      "role": "Viewer",
      "type": "Group",
      "fqn": "aadgroup=some_guid",
      "email": "kusto@microsoft.com",
      "appId": ""
    },
    {
      "name": "SomeApp",
      "role": "Admin",
      "type": "App",
      "fqn": "aadapp=some_guid_app_id",
      "email": "",
      "appId": "some_guid_app_id"
    }
  ]
}

Definitionen

Name Beschreibung
DatabasePrincipal

Eine Klasse, die die Datenbankprinzipalentität darstellt.

DatabasePrincipalListResult

Die Antwort auf den Vorgang der Kusto-Datenbankprinzipale.

DatabasePrincipalRole

Datenbankprinzipalrolle.

DatabasePrincipalType

Datenbankprinzipaltyp.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

DatabasePrincipal

Eine Klasse, die die Datenbankprinzipalentität darstellt.

Name Typ Beschreibung
appId

string

Anwendungs-ID– nur für den Anwendungsprinzipaltyp relevant.

email

string

Datenbankprinzipal-E-Mail, falls vorhanden.

fqn

string

Vollqualifizierter Datenbankprinzipalname.

name

string

Datenbankprinzipalname.

role

DatabasePrincipalRole

Datenbankprinzipalrolle.

tenantName

string

Der Mandantenname des Prinzipals

type

DatabasePrincipalType

Datenbankprinzipaltyp.

DatabasePrincipalListResult

Die Antwort auf den Vorgang der Kusto-Datenbankprinzipale.

Name Typ Beschreibung
value

DatabasePrincipal[]

Die Liste der Kusto-Datenbankprinzipale.

DatabasePrincipalRole

Datenbankprinzipalrolle.

Name Typ Beschreibung
Admin

string

Ingestor

string

Monitor

string

UnrestrictedViewer

string

User

string

Viewer

string

DatabasePrincipalType

Datenbankprinzipaltyp.

Name Typ Beschreibung
App

string

Group

string

User

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.