Freigeben über


Kusto Pool Database Principal Assignments - Create Or Update

Erstellt eine Kusto-Pooldatenbank principalAssignment.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/kustoPools/{kustoPoolName}/databases/{databaseName}/principalAssignments/{principalAssignmentName}?api-version=2021-06-01-preview

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
path True

string

Der Name der Datenbank im Kusto-Pool.

kustoPoolName
path True

string

Der Name des Kusto-Pools.

principalAssignmentName
path True

string

Der Name des Kusto principalAssignment.

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.

workspaceName
path True

string

Den Namen des Arbeitsbereichs

api-version
query True

string

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

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.principalId True

string

Die dem Datenbankprinzipal zugewiesene Prinzipal-ID. Dabei kann es sich um eine Benutzer-E-Mail,Anwendungs-ID oder einen Namen der Sicherheitsgruppe handeln.

properties.principalType True

PrincipalType

Prinzipaltyp.

properties.role True

DatabasePrincipalRole

Datenbankprinzipalrolle.

properties.tenantId

string

Die Mandanten-ID des Prinzipals

Antworten

Name Typ Beschreibung
200 OK

DatabasePrincipalAssignment

Die PrincipalAssignments wurden erfolgreich aktualisiert.

201 Created

DatabasePrincipalAssignment

Die principalAssignments wurden erfolgreich erstellt.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Beispiele

KustoPoolDatabasePrincipalAssignmentsCreateOrUpdate

Beispielanforderung

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Synapse/workspaces/synapseWorkspaceName/kustoPools/kustoclusterrptest4/databases/Kustodatabase8/principalAssignments/kustoprincipal1?api-version=2021-06-01-preview

{
  "properties": {
    "role": "Admin",
    "principalId": "87654321-1234-1234-1234-123456789123",
    "principalType": "App",
    "tenantId": "12345678-1234-1234-1234-123456789123"
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Synapse/workspaces/synapseWorkspaceName/kustoPools/kustoclusterrptest4/Databases/Kustodatabase8/PrincipalAssignments/kustoprincipal1",
  "name": "synapseWorkspaceName/kustoclusterrptest4/Kustodatabase8/kustoprincipal1",
  "type": "Microsoft.Synapse/Workspaces/KustoPools/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"
  }
}
{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Synapse/workspaces/synapseWorkspaceName/kustoPools/kustoclusterrptest4/Databases/Kustodatabase8/PrincipalAssignments/kustoprincipal1",
  "name": "synapseWorkspaceName/kustoclusterrptest4/Kustodatabase8/kustoprincipal1",
  "type": "Microsoft.Synapse/Workspaces/KustoPools/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
createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DatabasePrincipalAssignment

Klasse, die eine Datenbankprinzipalzuweisung darstellt.

DatabasePrincipalRole

Datenbankprinzipalrolle.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

PrincipalType

Prinzipaltyp.

ResourceProvisioningState

Der bereitgestellte Zustand der Ressource.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

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 Benutzer-E-Mail,Anwendungs-ID oder einen Namen der Sicherheitsgruppe handeln.

properties.principalName

string

Der Prinzipalname

properties.principalType

PrincipalType

Prinzipaltyp.

properties.provisioningState

ResourceProvisioningState

Der bereitgestellte Zustand der Ressource.

properties.role

DatabasePrincipalRole

Datenbankprinzipalrolle.

properties.tenantId

string

Die Mandanten-ID des Prinzipals

properties.tenantName

string

Der Mandantenname des Prinzipals

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

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

ResourceProvisioningState

Der bereitgestellte Zustand der Ressource.

Name Typ Beschreibung
Canceled

string

Creating

string

Deleting

string

Failed

string

Moving

string

Running

string

Succeeded

string

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.