Database Principal Assignments - Get

Usługa:

Azure Kusto

Wersja interfejsu API:

2025-02-14

Pobiera jednostkę bazy danych klastra KustoPrzypisania.

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

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.
principalAssignmentName	path	True	string pattern: ^.*$	Nazwa podmiotu zabezpieczeń KustoPrzypisania.
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	DatabasePrincipalAssignment	Operacja Azure zakończyła się pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

KustoDatabasePrincipalAssignmentsGet

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster/databases/Kustodatabase8/principalAssignments/kustoprincipal1?api-version=2025-02-14

Przykładowa odpowiedź

Kod stanu:

200

{
  "name": "kustoCluster/Kustodatabase8/kustoprincipal1",
  "type": "Microsoft.Kusto/Clusters/Databases/PrincipalAssignments",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster/Databases/Kustodatabase8/PrincipalAssignments/kustoprincipal1",
  "properties": {
    "aadObjectId": "98765432-1234-1234-1234-123456789123",
    "principalId": "87654321-1234-1234-1234-123456789123",
    "principalName": "TestApp",
    "principalType": "App",
    "provisioningState": "Succeeded",
    "role": "Admin",
    "tenantId": "12345678-1234-1234-1234-123456789123",
    "tenantName": "tenantName"
  }
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
DatabasePrincipalAssignment	Klasa reprezentująca główne zadanie bazy danych.
DatabasePrincipalRole	Rola główna bazy danych.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
PrincipalType	Typ podmiotu zabezpieczeń.
ProvisioningState	Stan aprowizacji zasobu.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

DatabasePrincipalAssignment

Objekt

Klasa reprezentująca główne zadanie bazy danych.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties.aadObjectId	string	Identyfikator obiektu principal w AAD (Azure Active Directory)
properties.principalId	string	Identyfikator podmiotu zabezpieczeń przypisany do podmiotu zabezpieczeń bazy danych. Może to być adres e-mail użytkownika, identyfikator aplikacji lub nazwa grupy zabezpieczeń.
properties.principalName	string	Główna nazwa
properties.principalType	PrincipalType	Typ podmiotu zabezpieczeń.
properties.provisioningState	ProvisioningState	Stan aprowizacji zasobu.
properties.role	DatabasePrincipalRole	Rola główna bazy danych.
properties.tenantId	string	Identyfikator dzierżawy podmiotu zabezpieczeń
properties.tenantName	string	Nazwisko najemcy dyrektora
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

DatabasePrincipalRole

Wyliczenie

Rola główna bazy danych.

Wartość	Opis
Admin	Administrator
Ingestor	Ingestor
Monitor	Monitor
User	Użytkownik
UnrestrictedViewer	UnrestrictedViewer
Viewer	Przeglądarka

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	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

PrincipalType

Wyliczenie

Typ podmiotu zabezpieczeń.

Wartość	Opis
App	Aplikacja
Group	Grupa
User	Użytkownik

ProvisioningState

Wyliczenie

Stan aprowizacji zasobu.

Wartość	Opis
Running	Bieganie
Creating	Tworzenie
Deleting	Usuwanie
Succeeded	Powodzenie
Failed	Niepowodzenie
Moving	Wzruszający
Canceled	Anulowane

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.