Freigeben über


Database Principal Assignments - Get

Ruft eine Kusto-Clusterdatenbank principalAssignment ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
path True

string

Der Name des Kusto-Clusters.

RegEx-Muster: ^.*$

databaseName
path True

string

Der Name der Datenbank im Kusto-Cluster.

RegEx-Muster: ^.*$

principalAssignmentName
path True

string

Der Name des Kusto principalAssignment.

RegEx-Muster: ^.*$

resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

DatabasePrincipalAssignment

Das Kusto-Clusterdatenbankprinzipalzuweisungsobjekt.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Beispiele

KustoDatabasePrincipalAssignmentsGet

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
DatabasePrincipalAssignment

Klasse, die eine Datenbankprinzipalzuweisung darstellt.

DatabasePrincipalRole

Datenbankprinzipalrolle.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

PrincipalType

Prinzipaltyp.

ProvisioningState

Der bereitgestellte Zustand der Ressource.

DatabasePrincipalAssignment

Klasse, die eine Datenbankprinzipalzuweisung darstellt.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Der Name der Ressource

properties.aadObjectId

string

Die Dienstprinzipalobjekt-ID in AAD (Azure Active Directory)

properties.principalId

string

Die dem Datenbankprinzipal zugewiesene Prinzipal-ID. Dabei kann es sich um eine E-Mail-Adresse des Benutzers, eine Anwendungs-ID oder einen Sicherheitsgruppennamen handeln.

properties.principalName

string

Der Prinzipalname

properties.principalType

PrincipalType

Prinzipaltyp.

properties.provisioningState

ProvisioningState

Der bereitgestellte Zustand der Ressource.

properties.role

DatabasePrincipalRole

Datenbankprinzipalrolle.

properties.tenantId

string

Die Mandanten-ID des Prinzipals

properties.tenantName

string

Der Mandantenname des Prinzipals

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

DatabasePrincipalRole

Datenbankprinzipalrolle.

Name Typ Beschreibung
Admin

string

Ingestor

string

Monitor

string

UnrestrictedViewer

string

User

string

Viewer

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

PrincipalType

Prinzipaltyp.

Name Typ Beschreibung
App

string

Group

string

User

string

ProvisioningState

Der bereitgestellte Zustand der Ressource.

Name Typ Beschreibung
Canceled

string

Creating

string

Deleting

string

Failed

string

Moving

string

Running

string

Succeeded

string