Database Principal Assignments - Get

Layanan:

Azure Kusto

Versi API:

2025-02-14

Mendapatkan database kluster Kusto principalAssignment.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
clusterName	path	True	string pattern: ^.*$	Nama kluster Kusto.
databaseName	path	True	string pattern: ^.*$	Nama database dalam kluster Kusto.
principalAssignmentName	path	True	string pattern: ^.*$	Nama kusto principalAssignment.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	DatabasePrincipalAssignment	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

KustoDatabasePrincipalAssignmentsGet

Permintaan sampel

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

Respon sampel

Kode status:

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"
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
DatabasePrincipalAssignment	Kelas yang mewakili penugasan utama database.
DatabasePrincipalRole	Peran utama database.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
PrincipalType	Jenis utama.
ProvisioningState	Status sumber daya yang disediakan.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DatabasePrincipalAssignment

Objek

Kelas yang mewakili penugasan utama database.

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya
properties.aadObjectId	string	ID objek perwakilan layanan di AAD (Azure active directory)
properties.principalId	string	ID utama yang ditetapkan ke prinsipal database. Ini bisa berupa email pengguna, ID aplikasi, atau nama grup keamanan.
properties.principalName	string	Nama utama
properties.principalType	PrincipalType	Jenis utama.
properties.provisioningState	ProvisioningState	Status sumber daya yang disediakan.
properties.role	DatabasePrincipalRole	Peran utama database.
properties.tenantId	string	Id penyewa dari prinsipal
properties.tenantName	string	Nama penyewa prinsipal
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

DatabasePrincipalRole

Enumerasi

Peran utama database.

Nilai	Deskripsi
Admin	Admin
Ingestor	Ingestor
Monitor	Monitor
User	Pengguna
UnrestrictedViewer	Penampil Tidak Dibatasi
Viewer	Penampil

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

PrincipalType

Enumerasi

Jenis utama.

Nilai	Deskripsi
App	Aplikasi
Group	Kelompok
User	Pengguna

ProvisioningState

Enumerasi

Status sumber daya yang disediakan.

Nilai	Deskripsi
Running	Running
Creating	Membuat
Deleting	Menghapus
Succeeded	Berhasil
Failed	Kegagalan
Moving	Bergerak
Canceled	Dibatalkan

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.