Databases - List Principals

Reference

Služba:: Azure Kusto

Verze rozhraní API:: 2024-04-13

Vrátí seznam objektů zabezpečení databáze daného clusteru Kusto a databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
clusterName	path	True	string	Název clusteru Kusto. Vzor regulárního výrazu: `^.*$`
databaseName	path	True	string	Název databáze v clusteru Kusto. Vzor regulárního výrazu: `^.*$`
resourceGroupName	path	True	string	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string	ID cílového předplatného.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	DatabasePrincipalListResult	Seznam objektů zabezpečení databáze se úspěšně načetl.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Příklady

KustoDatabaseListPrincipals

Ukázkový požadavek

HTTP

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster/databases/KustoDatabase8/listPrincipals?api-version=2024-04-13

Ukázková odpověď

Stavový kód:: 200

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

Definice

Name	Description
DatabasePrincipal	Třída představující hlavní entitu databáze.
DatabasePrincipalListResult	Seznam odpovědí operace operace instančních objektů databáze Kusto.
DatabasePrincipalRole	Role instančního objektu databáze
DatabasePrincipalType	Typ objektu zabezpečení databáze.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď

DatabasePrincipal

Třída představující hlavní entitu databáze.

Name	Typ	Description
appId	string	ID aplikace – relevantní pouze pro typ objektu zabezpečení aplikace.
email	string	Pokud existuje e-mail instančního objektu databáze.
fqn	string	Plně kvalifikovaný název instančního objektu databáze
name	string	Hlavní název databáze.
role	DatabasePrincipalRole	Role instančního objektu databáze
tenantName	string	Název tenanta objektu zabezpečení
type	DatabasePrincipalType	Typ objektu zabezpečení databáze.

DatabasePrincipalListResult

Seznam odpovědí operace operace instančních objektů databáze Kusto.

Name	Typ	Description
value	DatabasePrincipal[]	Seznam objektů zabezpečení databáze Kusto.

DatabasePrincipalRole

Role instančního objektu databáze

Name	Typ	Description
Admin	string
Ingestor	string
Monitor	string
UnrestrictedViewer	string
User	string
Viewer	string

DatabasePrincipalType

Typ objektu zabezpečení databáze.

Name	Typ	Description
App	string
Group	string
User	string

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Sdílet prostřednictvím