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 |
|---|---|---|---|---|
|
cluster
|
path | True |
string pattern: ^.*$ |
Nome del cluster Kusto. |
|
database
|
path | True |
string pattern: ^.*$ |
Nome del database nel cluster Kusto. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
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 |
Operazione Azure completata con successo. |
|
| Other Status Codes |
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 |
|---|---|
|
Database |
Una classe che rappresenta l'entità principale del database. |
|
Database |
L'elenco dei principali del database Kusto risponde all'operazione. |
|
Database |
Ruolo dell'entità di database. |
|
Database |
Tipo di principale database. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
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. |
|
string |
Se esiste l'email principale del database. |
|
| fqn |
string |
Titolare del database nome pienamente qualificato. |
| name |
string |
Nome principale del database. |
| role |
Ruolo dell'entità di database. |
|
| tenantName |
string |
Il nome del titolare del principale |
| type |
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 |
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 |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |