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 |
---|---|---|---|---|
database
|
path | True |
string |
Der Name der Datenbank im Kusto-Pool. |
kusto
|
path | True |
string |
Der Name des Kusto-Pools. |
principal
|
path | True |
string |
Der Name des Kusto principalAssignment. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
workspace
|
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 |
Prinzipaltyp. |
|
properties.role | True |
Datenbankprinzipalrolle. |
|
properties.tenantId |
string |
Die Mandanten-ID des Prinzipals |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die PrincipalAssignments wurden erfolgreich aktualisiert. |
|
201 Created |
Die principalAssignments wurden erfolgreich erstellt. |
|
Other Status Codes |
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 |
---|---|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Database |
Klasse, die eine Datenbankprinzipalzuweisung darstellt. |
Database |
Datenbankprinzipalrolle. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Principal |
Prinzipaltyp. |
Resource |
Der bereitgestellte Zustand der Ressource. |
system |
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 |
Prinzipaltyp. |
|
properties.provisioningState |
Der bereitgestellte Zustand der Ressource. |
|
properties.role |
Datenbankprinzipalrolle. |
|
properties.tenantId |
string |
Die Mandanten-ID des Prinzipals |
properties.tenantName |
string |
Der Mandantenname des Prinzipals |
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 |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
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 |
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 |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |