Databases - List Principals

Retourneert een lijst met database-principals van het opgegeven Kusto-cluster en de opgegeven database.

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

URI-parameters

Name In Required Type Description
clusterName
path True
  • string

De naam van het Kusto-cluster.

databaseName
path True
  • string

De naam van de database in het Kusto-cluster.

resourceGroupName
path True
  • string

De naam van de resourcegroep die het Kusto-cluster bevat.

subscriptionId
path True
  • string

Haalt abonnementsreferenties op die een unieke identificatie Microsoft Azure abonnement. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

api-version
query True
  • string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

De lijst met database-principals is opgehaald.

Other Status Codes

Foutbericht waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

KustoDatabaseListPrincipals

Sample Request

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoclusterrptest4/databases/KustoDatabase8/listPrincipals?api-version=2021-01-01

Sample Response

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

Definities

CloudError

Een foutbericht van Kusto.

CloudErrorBody

Een foutbericht van Kusto.

DatabasePrincipal

Een klasse die de database-principal-entiteit vertegenwoordigt.

DatabasePrincipalListResult

De lijst met bewerkingsreacties voor Kusto-database-principals.

DatabasePrincipalRole

Database-principal-rol.

DatabasePrincipalType

Type database-principal.

CloudError

Een foutbericht van Kusto.

Name Type Description
error

Een foutbericht van Kusto.

CloudErrorBody

Een foutbericht van Kusto.

Name Type Description
code
  • string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

details

Een lijst met aanvullende details over de fout.

message
  • string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

target
  • string

Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

DatabasePrincipal

Een klasse die de database-principal-entiteit vertegenwoordigt.

Name Type Description
appId
  • string

Toepassings-id: alleen relevant voor het principal-type van de toepassing.

email
  • string

E-mailadres van database-principal, indien aanwezig.

fqn
  • string

Volledig gekwalificeerde naam van database-principal.

name
  • string

Principal-naam van database.

role

Database-principal-rol.

tenantName
  • string

De tenantnaam van de principal

type

Type database-principal.

DatabasePrincipalListResult

De lijst met bewerkingsreacties voor Kusto-database-principals.

Name Type Description
value

De lijst met Kusto-database-principals.

DatabasePrincipalRole

Database-principal-rol.

Name Type Description
Admin
  • string
Ingestor
  • string
Monitor
  • string
UnrestrictedViewer
  • string
User
  • string
Viewer
  • string

DatabasePrincipalType

Type database-principal.

Name Type Description
App
  • string
Group
  • string
User
  • string