Admin - Groups UpdateGroupAsAdmin

Ссылка

Служба:: Power BI REST APIs

Версия API:: v1.0

Обновления свойства указанной рабочей области.

Чтобы отменить назначение рабочей области Log Analytics, явно задайте значение NULL.

Разрешения

Пользователь должен иметь права администратора (например, Office 365 глобального администратора или администратора службы Power BI).

Требуемая область

Tenant.ReadWrite.All

Ограничения

Максимум 200 запросов в час.
Для общих емкостей можно обновить только имя и описание.
Для емкостей Premium можно обновить только имя, описание, defaultDatasetStorageFormat и рабочую область Log Analytics.
Имя должно быть уникальным внутри организации.

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}

Параметры URI

Имя	В	Обязательно	Тип	Описание
groupId	path	True	string uuid	идентификатор рабочей области;

Текст запроса

Имя	Обязательно	Тип	Описание
id	True	string	идентификатор рабочей области;
capacityId		string	Идентификатор емкости
dashboards		AdminDashboard[]	Панели мониторинга, принадлежащие группе
dataflowStorageId		string	Идентификатор учетной записи хранения потока данных Power BI
dataflows		AdminDataflow[]	Потоки данных, принадлежащие группе
datasets		AdminDataset[]	Наборы данных, принадлежащие группе
defaultDatasetStorageFormat		DefaultDatasetStorageFormat	Формат хранилища набора данных по умолчанию в рабочей области. Возвращается только в том случае, если `isOnDedicatedCapacity` имеет значение `true`
description		string	Описание группы
hasWorkspaceLevelSettings		boolean	Наличие настраиваемых параметров в рабочей области
isOnDedicatedCapacity		boolean	Указывает, назначена ли группа выделенной емкости
isReadOnly		boolean	Является ли группа доступной только для чтения
logAnalyticsWorkspace		AzureResource	Рабочая область Log Analytics, назначенная группе. Возвращается только при получении одной группы.
name		string	Имя группы
pipelineId		string	Идентификатор конвейера развертывания, которому назначена рабочая область.
reports		AdminReport[]	Отчеты, принадлежащие группе
state		string	Состояние группы
type		GroupType	Тип возвращаемой группы.
users		GroupUser[]	(Пустое значение) Пользователи, принадлежащие группе, и их права доступа. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователе в элементе Power BI (например, отчете или панели мониторинга) с помощью вызова API Get Group Users As Администратор или вызова API PostWorkspaceInfo с параметром `getArtifactUsers` .
workbooks		Workbook[]	Книги, принадлежащие группе

Ответы

Имя	Тип	Описание
200 OK		ОК

Примеры

Example of assigning Log Analytics workspace

Example of unassigning Log Analytics workspace

Example of updating group description and defaultDatasetStorageFormat

Example of assigning Log Analytics workspace

Образец запроса

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332

Текст запроса

{
  "logAnalyticsWorkspace": {
    "subscriptionId": "d778934f-bda2-41d9-b5c7-6cf41372c1a0",
    "resourceGroup": "myResourceGroup",
    "resourceName": "myLogAnalyticsWorkspace"
  }
}

Пример ответа

Код состояния:: 200

Example of unassigning Log Analytics workspace

Образец запроса

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332

Текст запроса

{
  "logAnalyticsWorkspace": null
}

Пример ответа

Код состояния:: 200

Example of updating group description and defaultDatasetStorageFormat

Образец запроса

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332

Текст запроса

{
  "name": "Updated Sales Results",
  "description": "Refreshed sales numbers",
  "defaultDatasetStorageFormat": "Large"
}

Пример ответа

Код состояния:: 200

Определения

Имя	Описание
AdminDashboard	Панель мониторинга Power BI, возвращаемая Администратор API. API возвращает подмножество из следующего списка свойств панели мониторинга. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.
AdminDataflow	Метаданные потока данных, возвращаемые API Администратор. Ниже приведен список свойств, которые могут быть возвращены для потока данных. Будет возвращено только подмножество свойств в зависимости от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.
AdminDataset	Набор данных Power BI, возвращаемый api Администратор. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.
AdminGroup	Группа Power BI, возвращаемая API-интерфейсами администратора
AdminReport	Отчет Power BI, возвращаемый Администратор API. API возвращает подмножество из следующего списка свойств отчета. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.
AdminTile	Плитка Power BI, возвращаемая api Администратор.
AzureResource	Ответ с подробными сведениями о ресурсе Azure, принадлежавом пользователю, например рабочей области Log Analytics.
DashboardUser	Запись прав доступа пользователя Power BI для панели мониторинга
DashboardUserAccessRight	Право доступа, которое пользователь имеет для панели мониторинга (уровень разрешений)
DataflowUser	Запись права доступа пользователя Power BI для потока данных
DataflowUserAccessRight	Право доступа, которое пользователь имеет для потока данных (уровень разрешений)
DatasetQueryScaleOutSettings	Параметры масштабирования запроса для набора данных
DatasetUser	Запись права доступа пользователя Power BI для набора данных
DatasetUserAccessRight	Право доступа, которое пользователь имеет для набора данных (уровень разрешений)
DefaultDatasetStorageFormat	Формат хранилища набора данных по умолчанию в группе
DependentDataflow	Поток данных, зависящий от Power BI
Encryption	Сведения о шифровании для набора данных
EncryptionStatus	Состояние шифрования набора данных
GroupType	Тип группы
GroupUser	Пользователь Power BI с доступом к рабочей области
GroupUserAccessRight	Право доступа (уровень разрешений), которое пользователь имеет в рабочей области
PrincipalType	Тип субъекта
ReportUser	Запись права доступа пользователя Power BI для отчета
ReportUserAccessRight	Право доступа, которое пользователь имеет для отчета (уровень разрешений)
ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
Subscription	Подписка электронной почты на элемент Power BI (например, отчет или панель мониторинга)
SubscriptionUser	Пользователь подписки на электронную почту Power BI
Workbook	Книга Power BI

AdminDashboard

Панель мониторинга Power BI, возвращаемая Администратор API. API возвращает подмножество из следующего списка свойств панели мониторинга. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

Имя	Тип	Описание
appId	string	Идентификатор приложения, возвращаемый только в том случае, если панель мониторинга принадлежит приложению.
displayName	string	Отображаемое имя панели мониторинга
embedUrl	string	URL-адрес внедрения панели мониторинга
id	string	Идентификатор панели мониторинга
isReadOnly	boolean	Указывает, доступна ли панель мониторинга только для чтения
subscriptions	Subscription[]	(Пустое значение) Сведения о подписке для элемента Power BI (например, отчета или панели мониторинга). Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о подписке для отчета Power BI можно получить с помощью команды Получить подписки на отчеты как Администратор вызов API.
tiles	AdminTile[]	Плитки, принадлежащие панели мониторинга
users	DashboardUser[]	(Пустое значение) Сведения о доступе пользователя к панели мониторинга. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о пользователях на панели мониторинга Power BI можно получить с помощью команды Get Dashboard Users as Администратор вызова API или вызова API PostWorkspaceInfo с параметром `getArtifactUsers` .
webUrl	string	URL-адрес панели мониторинга
workspaceId	string	Идентификатор рабочей области (GUID) панели мониторинга. Это свойство будет возвращено только в GetDashboardsAsAdmin.

AdminDataflow

Метаданные потока данных, возвращаемые API Администратор. Ниже приведен список свойств, которые могут быть возвращены для потока данных. Будет возвращено только подмножество свойств в зависимости от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

Имя	Тип	Описание
configuredBy	string	Владелец потока данных
description	string	Описание потока данных
modelUrl	string	URL-адрес файла определения потока данных (model.json)
modifiedBy	string	Пользователь, изменяющий поток данных
modifiedDateTime	string	Дата и время последнего изменения потока данных
name	string	Имя потока данных
objectId	string	Идентификатор потока данных
users	DataflowUser[]	(Пустое значение) Сведения о доступе пользователя к потоку данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о пользователях в потоке данных Power BI можно получить с помощью метода Get Dataflow Users (Получение пользователей потока данных в качестве вызова API Администратор) или вызова API PostWorkspaceInfo с параметром `getArtifactUser` .
workspaceId	string	Идентификатор рабочей области потока данных.

AdminDataset

Набор данных Power BI, возвращаемый api Администратор. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

Имя	Тип	Описание
ContentProviderType	string	Тип поставщика контента для набора данных
CreateReportEmbedURL	string	URL-адрес внедрения отчета создания набора данных
CreatedDate	string	Дата и время создания набора данных
Encryption	Encryption	Сведения о шифровании набора данных. Применимо, только если `$expand` указан параметр .
IsEffectiveIdentityRequired	boolean	Требуется ли набору данных действующее удостоверение, которое необходимо отправить в вызове API GenerateToken .
IsEffectiveIdentityRolesRequired	boolean	Определяется ли безопасность на уровне строк в PBIX-файле Power BI. Если да, необходимо указать роль.
IsInPlaceSharingEnabled	boolean	Можно ли предоставить доступ к набору данных внешним пользователям для использования в их собственном клиенте
IsOnPremGatewayRequired	boolean	Требуется ли набору данных локальный шлюз данных
IsRefreshable	boolean	Является ли набор данных обновляемым или нет. Обновляемый набор данных Power BI — это набор данных, который обновлялся по крайней мере один раз или для которого существует допустимое расписание обновления.
QnaEmbedURL	string	URL-адрес внедрения набора данных Q&A
addRowsAPIEnabled	boolean	Позволяет ли набор данных добавлять новые строки
configuredBy	string	Владелец набора данных
description	string	Описание набора данных
id	string	Идентификатор набора данных
name	string	Имя набора данных
queryScaleOutSettings	DatasetQueryScaleOutSettings	Параметры масштабирования запроса для набора данных
targetStorageMode	string	Режим хранения набора данных
upstreamDataflows	DependentDataflow[]	Список всех потоков данных, от которые зависит этот элемент
users	DatasetUser[]	(Пустое значение) Сведения о доступе пользователя к набору данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о пользователях элемента Power BI (например, отчет или панель мониторинга) можно получить с помощью API получения набора данных в качестве Администратор API или API PostWorkspaceInfo с параметром `getArtifactUsers` .
webUrl	string	URL-адрес набора данных
workspaceId	string	Идентификатор рабочей области набора данных. Это свойство будет возвращено только в GetDatasetsAsAdmin.

AdminGroup

Группа Power BI, возвращаемая API-интерфейсами администратора

Имя	Тип	Описание
capacityId	string	Идентификатор емкости
dashboards	AdminDashboard[]	Панели мониторинга, принадлежащие группе
dataflowStorageId	string	Идентификатор учетной записи хранения потока данных Power BI
dataflows	AdminDataflow[]	Потоки данных, принадлежащие группе
datasets	AdminDataset[]	Наборы данных, принадлежащие группе
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Формат хранилища набора данных по умолчанию в рабочей области. Возвращается только в том случае, если `isOnDedicatedCapacity` имеет значение `true`
description	string	Описание группы
hasWorkspaceLevelSettings	boolean	Наличие настраиваемых параметров в рабочей области
id	string	идентификатор рабочей области;
isOnDedicatedCapacity	boolean	Указывает, назначена ли группа выделенной емкости
isReadOnly	boolean	Является ли группа доступной только для чтения
logAnalyticsWorkspace	AzureResource	Рабочая область Log Analytics, назначенная группе. Возвращается только при получении одной группы.
name	string	Имя группы
pipelineId	string	Идентификатор конвейера развертывания, которому назначена рабочая область.
reports	AdminReport[]	Отчеты, принадлежащие группе
state	string	Состояние группы
type	GroupType	Тип возвращаемой группы.
users	GroupUser[]	(Пустое значение) Пользователи, принадлежащие группе, и их права доступа. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователе в элементе Power BI (например, отчете или панели мониторинга) с помощью вызова API Get Group Users As Администратор или вызова API PostWorkspaceInfo с параметром `getArtifactUsers` .
workbooks	Workbook[]	Книги, принадлежащие группе

AdminReport

Отчет Power BI, возвращаемый Администратор API. API возвращает подмножество из следующего списка свойств отчета. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

Имя	Тип	Описание
appId	string	Идентификатор приложения, возвращаемый только в том случае, если отчет принадлежит приложению.
createdBy	string	Владелец отчета. Доступно только для отчетов, созданных после июня 2019 г.
createdDateTime	string	Дата и время создания отчета
datasetId	string	Идентификатор набора данных отчета
description	string	Описание отчета
embedUrl	string	URL-адрес внедрения отчета
id	string	Идентификатор отчета
isOwnedByMe	boolean	Определите, создан ли отчет текущим пользователем.
modifiedBy	string	Последний пользователь, изменяющий отчет
modifiedDateTime	string	Дата и время последнего изменения отчета
name	string	Имя отчета
originalReportId	string	Фактический идентификатор отчета при публикации рабочей области в виде приложения.
reportType	enum: PaginatedReport PowerBIReport	Тип отчета
subscriptions	Subscription[]	(Пустое значение) Сведения о подписке для элемента Power BI (например, отчета или панели мониторинга). Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о подписке для отчета Power BI можно получить с помощью команды Получить подписки на отчеты как Администратор вызов API.
users	ReportUser[]	(Пустое значение) Сведения о доступе пользователей к отчету Power BI. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователях в отчете Power BI с помощью метода Get Report Users as Администратор API или вызова API PostWorkspaceInfo с параметром `getArtifactUsers` .
webUrl	string	URL-адрес отчета в интернете
workspaceId	string	Идентификатор рабочей области (GUID) отчета. Это свойство будет возвращено только в GetReportsAsAdmin.

AdminTile

Плитка Power BI, возвращаемая api Администратор.

Имя	Тип	Описание
colSpan	integer	Количество столбцов диапазона плиток
datasetId	string	Идентификатор набора данных. Доступно только для плиток, созданных из отчета или с помощью набора данных, таких как плитки Q&A.
embedData	string	Данные внедрения для плитки
embedUrl	string	URL-адрес внедрения плитки
id	string	Идентификатор плитки
reportId	string	Идентификатор отчета. Доступно только для плиток, созданных из отчета.
rowSpan	integer	Количество строк диапазона плиток
title	string	Отображаемое имя плитки

AzureResource

Ответ с подробными сведениями о ресурсе Azure, принадлежавом пользователю, например рабочей области Log Analytics.

Имя	Тип	Описание
id	string	Идентификатор ресурса в Power BI.
resourceGroup	string	Группа ресурсов в подписке, в которой находится ресурс.
resourceName	string	Имя ресурса.
subscriptionId	string	Подписка Azure, в которой находится ресурс.

DashboardUser

Запись прав доступа пользователя Power BI для панели мониторинга

Имя	Тип	Описание
dashboardUserAccessRight	DashboardUserAccessRight	Право доступа, которое пользователь имеет для панели мониторинга (уровень разрешений)
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
userType	string	Тип пользователя.

DashboardUserAccessRight

Право доступа, которое пользователь имеет для панели мониторинга (уровень разрешений)

Имя	Тип	Описание
None	string	Нет разрешений на содержимое на панели мониторинга
Owner	string	Предоставляет доступ на чтение, запись и повторное предоставление общего доступа к содержимому в отчете
Read	string	Предоставляет доступ на чтение к содержимому на панели мониторинга
ReadCopy	string	Предоставляет доступ на чтение и копирование содержимого на панели мониторинга
ReadReshare	string	Предоставление доступа для чтения и повторного доступа к содержимому на панели мониторинга
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому на панели мониторинга

DataflowUser

Запись права доступа пользователя Power BI для потока данных

Имя	Тип	Описание
DataflowUserAccessRight	DataflowUserAccessRight	Право доступа, которое пользователь имеет для потока данных (уровень разрешений)
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
userType	string	Тип пользователя.

DataflowUserAccessRight

Право доступа, которое пользователь имеет для потока данных (уровень разрешений)

Имя	Тип	Описание
None	string	Удаляет разрешение на доступ к содержимому в потоке данных
Owner	string	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в потоке данных
Read	string	Предоставляет доступ на чтение к содержимому в потоке данных
ReadReshare	string	Предоставляет доступ на чтение и повторное предоставление общего доступа к содержимому в потоке данных
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в потоке данных

DatasetQueryScaleOutSettings

Параметры масштабирования запроса для набора данных

Имя	Тип	Описание
autoSyncReadOnlyReplicas	boolean	Автоматически ли набор данных синхронизирует реплики только для чтения
maxReadOnlyReplicas	integer	Максимальное число реплик только для чтения для набора данных (0–64, –1 для автоматического числа реплик)

DatasetUser

Запись права доступа пользователя Power BI для набора данных

Имя	Тип	Описание
datasetUserAccessRight	DatasetUserAccessRight	Право доступа, которое пользователь имеет для набора данных (уровень разрешений)
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
userType	string	Тип пользователя.

DatasetUserAccessRight

Право доступа, которое пользователь имеет для набора данных (уровень разрешений)

Имя	Тип	Описание
None	string	Удаляет разрешение на содержимое в наборе данных.
Read	string	Предоставляет доступ на чтение к содержимому в наборе данных.
ReadExplore	string	Предоставляет доступ на чтение и просмотр к содержимому в наборе данных
ReadReshare	string	Предоставляет доступ для чтения и повторного доступа к содержимому в наборе данных.
ReadReshareExplore	string	Предоставляет доступ для чтения, повторного доступа и просмотра к содержимому в наборе данных.
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в наборе данных.
ReadWriteExplore	string	Предоставляет доступ для чтения, записи и просмотра к содержимому в наборе данных.
ReadWriteReshare	string	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в наборе данных.
ReadWriteReshareExplore	string	Предоставляет доступ для чтения, записи, повторного доступа и просмотра к содержимому в наборе данных.

DefaultDatasetStorageFormat

Формат хранилища набора данных по умолчанию в группе

Имя	Тип	Описание
Large	string	Формат хранения большого набора данных
Small	string	Формат хранения небольших наборов данных

DependentDataflow

Поток данных, зависящий от Power BI

Имя	Тип	Описание
groupId	string	Идентификатор целевой группы
targetDataflowId	string	Идентификатор целевого потока данных

Encryption

Сведения о шифровании для набора данных

Имя	Тип	Описание
EncryptionStatus	EncryptionStatus	Состояние шифрования набора данных

EncryptionStatus

Состояние шифрования набора данных

Имя	Тип	Описание
InSyncWithWorkspace	string	Шифрование поддерживается и синхронизируется с параметрами шифрования.
NotInSyncWithWorkspace	string	Шифрование поддерживается, но не синхронизируется с параметрами шифрования
NotSupported	string	Шифрование не поддерживается для этого набора данных
Unknown	string	Состояние шифрования неизвестно из-за повреждения набора данных

GroupType

Тип группы

Имя	Тип	Описание
Group	string	Версия 1 общей рабочей области. Этот тип рабочих областей будет нерекомендуем, так как корпорация Майкрософт переносит все рабочие области в последнюю версию общей рабочей области.
Personal	string	Специальный тип рабочей области, предназначенный для интеграции со списком SharePoint и OneDrive
PersonalGroup	string	"Моя рабочая область", также известная как личная рабочая область
Workspace	string	Общая рабочая область или простая рабочая область, используемая для совместного использования содержимого с другими пользователями в организации

GroupUser

Пользователь Power BI с доступом к рабочей области

Имя	Тип	Описание
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
groupUserAccessRight	GroupUserAccessRight	Право доступа (уровень разрешений), которое пользователь имеет в рабочей области
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
userType	string	Тип пользователя.

GroupUserAccessRight

Право доступа (уровень разрешений), которое пользователь имеет в рабочей области

Имя	Тип	Описание
Admin	string	Права администратора на содержимое рабочей области
Contributor	string	Чтение и изучение (ReadExplore) доступа к содержимому рабочей области
Member	string	Права на чтение, повторное совместное использование и изучение (ReadReshareExplore) для доступа к содержимому рабочей области
None	string	Нет доступа к содержимому рабочей области
Viewer	string	Доступ только для чтения (чтение) к содержимому рабочей области

PrincipalType

Тип субъекта

Имя	Тип	Описание
App	string	Тип субъекта-службы
Group	string	Тип субъекта-группы
None	string	Нет основного типа. Используйте для доступа на уровне всей организации.
User	string	Тип субъекта-пользователя

ReportUser

Запись права доступа пользователя Power BI для отчета

Имя	Тип	Описание
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
reportUserAccessRight	ReportUserAccessRight	Право доступа, которое пользователь имеет для отчета (уровень разрешений)
userType	string	Тип пользователя.

ReportUserAccessRight

Право доступа, которое пользователь имеет для отчета (уровень разрешений)

Имя	Тип	Описание
None	string	Нет разрешений на содержимое в отчете
Owner	string	Предоставляет доступ на чтение, запись и повторное предоставление общего доступа к содержимому в отчете
Read	string	Предоставляет доступ на чтение к содержимому отчета
ReadCopy	string	Предоставляет доступ на чтение и копирование содержимого в отчете
ReadReshare	string	Предоставляет доступ на чтение и повторное предоставление общего доступа к содержимому в отчете
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в отчете

ServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.

Имя	Тип	Описание
displayName	string	Имя профиля субъекта-службы
id	string	Идентификатор профиля субъекта-службы

Subscription

Подписка электронной почты на элемент Power BI (например, отчет или панель мониторинга)

Имя	Тип	Описание
artifactDisplayName	string	Имя подписанного элемента Power BI (например, отчета или панели мониторинга)
artifactId	string	Идентификатор элемента Power BI с подпиской (например, отчета или панели мониторинга)
artifactType	string	Тип элемента Power BI (например `Report`, , `Dashboard`или `Dataset`)
attachmentFormat	string	Формат отчета, вложенного в подписку электронной почты
endDate	string	Дата и время окончания подписки электронной почты
frequency	string	Частота подписки на электронную почту
id	string	Идентификатор подписки
isEnabled	boolean	Включена ли подписка на электронную почту
linkToContent	boolean	Существует ли ссылка на подписку в подписке электронной почты
previewImage	boolean	Существует ли снимок экрана отчета в подписке электронной почты
startDate	string	Дата и время начала подписки на электронную почту
subArtifactDisplayName	string	Имя страницы подписанного элемента Power BI, если это отчет.
title	string	Имя приложения
users	SubscriptionUser[]	Сведения о каждом подписчике электронной почты. При использовании вызова API Get User Subscriptions As Администратор возвращаемым значением является пустой массив (null). Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о подписке можно получить в отчете или на панели мониторинга Power BI с помощью команд API Получение подписок на отчеты как Администратор или Получение подписок панели мониторинга как Администратор вызовов API.

SubscriptionUser

Пользователь подписки на электронную почту Power BI

Имя	Тип	Описание
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
userType	string	Тип пользователя.

Workbook

Книга Power BI

Имя	Тип	Описание
datasetId	string	Идентификатор набора данных, связанного с книгой. Применяется, только если книга содержит связанный набор данных.
name	string	Имя книги

Поделиться через

Admin - Groups UpdateGroupAsAdmin

Разрешения

Требуемая область

Ограничения

Параметры URI

Текст запроса

Ответы

Примеры

Example of assigning Log Analytics workspace

Образец запроса

Пример ответа

Example of unassigning Log Analytics workspace

Образец запроса

Пример ответа

Example of updating group description and defaultDatasetStorageFormat

Образец запроса

Пример ответа

Определения

AdminDashboard

AdminDataflow

AdminDataset

AdminGroup

AdminReport

AdminTile

AzureResource

DashboardUser

DashboardUserAccessRight

DataflowUser

DataflowUserAccessRight

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DefaultDatasetStorageFormat

DependentDataflow

Encryption

EncryptionStatus

GroupType

GroupUser

GroupUserAccessRight

PrincipalType

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser

Workbook

Дополнительные ресурсы