Udostępnij przez

Databases - List Principals

Usługa:
Azure Kusto
Wersja interfejsu API:
2024-04-13

Zwraca listę podmiotów zabezpieczeń bazy danych danego klastra i bazy danych Kusto.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
clusterName
 path True

string

pattern: ^.*$

Nazwa klastra Kusto.
databaseName
 path True

string

pattern: ^.*$

Nazwa bazy danych w klastrze Kusto.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId
 path True

string

minLength: 1

Identyfikator subskrypcji docelowej.
api-version
 query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

DatabasePrincipalListResult

Pomyślnie pobrano listę podmiotów zabezpieczeń bazy danych.
Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Przykłady

KustoDatabaseListPrincipals

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
DatabasePrincipal

Klasa reprezentująca jednostkę główną bazy danych.
DatabasePrincipalListResult

Odpowiedź operacji podmiotów zabezpieczeń bazy danych Kusto.
DatabasePrincipalRole

Rola główna bazy danych.
DatabasePrincipalType

Typ podmiotu zabezpieczeń bazy danych.
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail

Szczegóły błędu.
ErrorResponse

Odpowiedź na błąd

DatabasePrincipal

Objekt

Klasa reprezentująca jednostkę główną bazy danych.

Nazwa Typ Opis
appId

string

Identyfikator aplikacji — dotyczy tylko typu podmiotu zabezpieczeń aplikacji.
email

string

Adres e-mail podmiotu zabezpieczeń bazy danych, jeśli istnieje.
fqn

string

W pełni kwalifikowana nazwa podmiotu zabezpieczeń bazy danych.
name

string

Główna nazwa bazy danych.
role

DatabasePrincipalRole

Rola główna bazy danych.
tenantName

string

Nazwa dzierżawy podmiotu zabezpieczeń
type

DatabasePrincipalType

Typ podmiotu zabezpieczeń bazy danych.

DatabasePrincipalListResult

Objekt

Odpowiedź operacji podmiotów zabezpieczeń bazy danych Kusto.

Nazwa Typ Opis
value

DatabasePrincipal[]

Lista podmiotów zabezpieczeń bazy danych Kusto.

DatabasePrincipalRole

Wyliczanie

Rola główna bazy danych.

Wartość Opis
Admin
Ingestor
Monitor
User
UnrestrictedViewer
Viewer

DatabasePrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń bazy danych.

Wartość Opis
App
Group
User

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.
type

string

Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.
code

string

Kod błędu.
details

ErrorDetail[]

Szczegóły błędu.
message

string

Komunikat o błędzie.
target

string

Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.