Condividi tramite


Databases - List Principals

Restituisce un elenco di entità di database del cluster e del database Kusto specificati.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
clusterName
path True

string

pattern: ^.*$

Nome del cluster Kusto.

databaseName
path True

string

pattern: ^.*$

Nome del database nel cluster Kusto.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

subscriptionId
path True

string

minLength: 1

ID della sottoscrizione di destinazione.

api-version
query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

DatabasePrincipalListResult

Operazione Azure completata con successo.

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

KustoDatabaseListPrincipals

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
DatabasePrincipal

Una classe che rappresenta l'entità principale del database.

DatabasePrincipalListResult

L'elenco dei principali del database Kusto risponde all'operazione.

DatabasePrincipalRole

Ruolo dell'entità di database.

DatabasePrincipalType

Tipo di principale database.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

DatabasePrincipal

Una classe che rappresenta l'entità principale del database.

Nome Tipo Descrizione
appId

string

ID applicazione - rilevante solo per il tipo principale dell'applicazione.

email

string

Se esiste l'email principale del database.

fqn

string

Titolare del database nome pienamente qualificato.

name

string

Nome principale del database.

role

DatabasePrincipalRole

Ruolo dell'entità di database.

tenantName

string

Il nome del titolare del principale

type

DatabasePrincipalType

Tipo di principale database.

DatabasePrincipalListResult

L'elenco dei principali del database Kusto risponde all'operazione.

Nome Tipo Descrizione
nextLink

string

Link alla pagina successiva dei risultati.

value

DatabasePrincipal[]

Elenco di entità di database Kusto.

DatabasePrincipalRole

Ruolo dell'entità di database.

Valore Descrizione
Admin

Amministratore di sistema

Ingestor

Ingestor

Monitor

Monitor

User

User

UnrestrictedViewer

UnrestrictedViewer

Viewer

Visualizzatore

DatabasePrincipalType

Tipo di principale database.

Valore Descrizione
App

Applicazione

Group

Gruppo

User

User

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.