Databases - List Principals

Mengembalikan daftar prinsipal database dari kluster dan database Kusto yang diberikan.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
clusterName
path True

string

Nama kluster Kusto.

Regex pattern: ^.*$

databaseName
path True

string

Nama database di kluster Kusto.

Regex pattern: ^.*$

resourceGroupName
path True

string

Nama grup sumber daya. Nama tidak peka huruf besar/kecil.

subscriptionId
path True

string

ID langganan target.

api-version
query True

string

Versi API yang digunakan untuk operasi ini.

Respons

Nama Jenis Deskripsi
200 OK

DatabasePrincipalListResult

Berhasil mengambil daftar prinsipal database.

Other Status Codes

ErrorResponse

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Contoh

KustoDatabaseListPrincipals

Sample Request

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster/databases/KustoDatabase8/listPrincipals?api-version=2023-08-15

Sample Response

{
  "value": [
    {
      "name": "Some User",
      "role": "Admin",
      "type": "User",
      "fqn": "aaduser=some_guid",
      "email": "user@microsoft.com",
      "appId": ""
    },
    {
      "name": "Kusto",
      "role": "Viewer",
      "type": "Group",
      "fqn": "aadgroup=some_guid",
      "email": "kusto@microsoft.com",
      "appId": ""
    },
    {
      "name": "SomeApp",
      "role": "Admin",
      "type": "App",
      "fqn": "aadapp=some_guid_app_id",
      "email": "",
      "appId": "some_guid_app_id"
    }
  ]
}

Definisi

Nama Deskripsi
DatabasePrincipal

Kelas yang mewakili entitas utama database.

DatabasePrincipalListResult

Daftar respons operasi prinsipal database Kusto.

DatabasePrincipalRole

Peran utama database.

DatabasePrincipalType

Jenis prinsipal database.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

DatabasePrincipal

Kelas yang mewakili entitas utama database.

Nama Jenis Deskripsi
appId

string

Id aplikasi - hanya relevan untuk jenis perwakilan aplikasi.

email

string

Email utama database jika ada.

fqn

string

Nama utama database yang sepenuhnya memenuhi syarat.

name

string

Nama utama database.

role

DatabasePrincipalRole

Peran utama database.

tenantName

string

Nama penyewa utama

type

DatabasePrincipalType

Jenis prinsipal database.

DatabasePrincipalListResult

Daftar respons operasi prinsipal database Kusto.

Nama Jenis Deskripsi
value

DatabasePrincipal[]

Daftar prinsipal database Kusto.

DatabasePrincipalRole

Peran utama database.

Nama Jenis Deskripsi
Admin

string

Ingestor

string

Monitor

string

UnrestrictedViewer

string

User

string

Viewer

string

DatabasePrincipalType

Jenis prinsipal database.

Nama Jenis Deskripsi
App

string

Group

string

User

string

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.