Databases - List Principals

Tjänst:: Azure Kusto

API-version:: 2025-02-14

Returnerar en lista över databashuvudnamn för det angivna Kusto-klustret och databasen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
clusterName	path	True	string pattern: ^.*$	Namnet på Kusto-klustret.
databaseName	path	True	string pattern: ^.*$	Namnet på databasen i Kusto-klustret.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	DatabasePrincipalListResult	Azure-operationen slutfördes framgångsrikt.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

KustoDatabaseListPrincipals

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 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"
    }
  ]
}

Definitioner

Name	Description
DatabasePrincipal	En klass som representerar databasens huvudenhet.
DatabasePrincipalListResult	Listan Kusto databasprincipals operationssvar.
DatabasePrincipalRole	Databasens huvudroll.
DatabasePrincipalType	Databasprinciptyp.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar

DatabasePrincipal

Objekt

En klass som representerar databasens huvudenhet.

Name	Typ	Description
appId	string	Applikations-id – relevant endast för applikationsprinciptyp.
email	string	Databasens huvudmejl om det finns.
fqn	string	Databasens huvudansvarige fullt kvalificerat namn.
name	string	Databasens huvudnamn.
role	DatabasePrincipalRole	Databasens huvudroll.
tenantName	string	Rektorns hyresgästnamn
type	DatabasePrincipalType	Databasprinciptyp.

DatabasePrincipalListResult

Objekt

Listan Kusto databasprincipals operationssvar.

Name	Typ	Description
nextLink	string	Länk till nästa sida med resultat.
value	DatabasePrincipal[]	Listan över Kusto-databashuvudnamn.

DatabasePrincipalRole

Uppräkning

Databasens huvudroll.

Värde	Description
Admin	Administratör
Ingestor	Ingestor
Monitor	Monitor
User	User
UnrestrictedViewer	UnrestrictedViewer
Viewer	Åskådare

DatabasePrincipalType

Uppräkning

Databasprinciptyp.

Värde	Description
App	Applikation
Group	Grupp
User	User

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.