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
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
cluster
|
path | True |
string |
Имя кластера Kusto. Шаблон регулярного выражения: |
database
|
path | True |
string |
Имя базы данных в кластере Kusto. Шаблон регулярного выражения: |
resource
|
path | True |
string |
Имя группы ресурсов. Регистр букв в имени не учитывается. |
subscription
|
path | True |
string |
Идентификатор целевой подписки. |
api-version
|
query | True |
string |
Версия API, используемая для данной операции. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Список субъектов базы данных успешно получен. |
|
Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Примеры
KustoDatabaseListPrincipals
Образец запроса
Пример ответа
{
"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"
}
]
}
Определения
Имя | Описание |
---|---|
Database |
Класс, представляющий сущность субъекта базы данных. |
Database |
Список ответов на операцию субъектов базы данных Kusto. |
Database |
Роль субъекта базы данных. |
Database |
Тип субъекта базы данных. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Сообщение об ошибке |
DatabasePrincipal
Класс, представляющий сущность субъекта базы данных.
Имя | Тип | Описание |
---|---|---|
appId |
string |
Идентификатор приложения — относится только к типу субъекта приложения. |
string |
Адрес электронной почты субъекта базы данных, если он существует. |
|
fqn |
string |
Полное имя субъекта базы данных. |
name |
string |
Имя субъекта базы данных. |
role |
Роль субъекта базы данных. |
|
tenantName |
string |
Имя клиента субъекта |
type |
Тип субъекта базы данных. |
DatabasePrincipalListResult
Список ответов на операцию субъектов базы данных Kusto.
Имя | Тип | Описание |
---|---|---|
value |
Список субъектов базы данных Kusto. |
DatabasePrincipalRole
Роль субъекта базы данных.
Имя | Тип | Описание |
---|---|---|
Admin |
string |
|
Ingestor |
string |
|
Monitor |
string |
|
UnrestrictedViewer |
string |
|
User |
string |
|
Viewer |
string |
DatabasePrincipalType
Тип субъекта базы данных.
Имя | Тип | Описание |
---|---|---|
App |
string |
|
Group |
string |
|
User |
string |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
error |
Объект ошибки. |