다음을 통해 공유


Databases - List Principals

지정된 Kusto 클러스터 및 데이터베이스의 데이터베이스 보안 주체 목록을 반환합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
clusterName
path True

string

Kusto 클러스터의 이름입니다.

regex 패턴: ^.*$

databaseName
path True

string

Kusto 클러스터에 있는 데이터베이스의 이름입니다.

regex 패턴: ^.*$

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

DatabasePrincipalListResult

데이터베이스 보안 주체 목록을 성공적으로 검색했습니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

KustoDatabaseListPrincipals

샘플 요청

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

샘플 응답

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

정의

Name Description
DatabasePrincipal

데이터베이스 주체 엔터티를 나타내는 클래스입니다.

DatabasePrincipalListResult

Kusto 데이터베이스 보안 주체 작업 응답 목록입니다.

DatabasePrincipalRole

데이터베이스 주체 역할.

DatabasePrincipalType

데이터베이스 보안 주체 유형입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

DatabasePrincipal

데이터베이스 주체 엔터티를 나타내는 클래스입니다.

Name 형식 Description
appId

string

애플리케이션 ID - 애플리케이션 보안 주체 유형에만 관련됩니다.

email

string

데이터베이스 보안 주체 이메일(있는 경우).

fqn

string

데이터베이스 보안 주체 정규화된 이름입니다.

name

string

데이터베이스 보안 주체 이름입니다.

role

DatabasePrincipalRole

데이터베이스 주체 역할.

tenantName

string

보안 주체의 테넌트 이름

type

DatabasePrincipalType

데이터베이스 보안 주체 유형입니다.

DatabasePrincipalListResult

Kusto 데이터베이스 보안 주체 작업 응답 목록입니다.

Name 형식 Description
value

DatabasePrincipal[]

Kusto 데이터베이스 보안 주체 목록입니다.

DatabasePrincipalRole

데이터베이스 주체 역할.

Name 형식 Description
Admin

string

Ingestor

string

Monitor

string

UnrestrictedViewer

string

User

string

Viewer

string

DatabasePrincipalType

데이터베이스 보안 주체 유형입니다.

Name 형식 Description
App

string

Group

string

User

string

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.