Разрешения REST API семантической модели
В этой статье описываются разрешения Power BI в целом и семантические разрешения модели в контексте REST API Power BI.
Разрешения в Power BI
Power BI имеет два набора разрешений:
Разрешения рабочей области
Разрешения рабочей области, также называемые разрешениями папок или ролями, являются самым высоким уровнем разрешений в Power BI. Эти разрешения переопределяют разрешения, которые предоставляются конкретному элементу в папке рабочей области.
В таблице ниже перечислены четыре типа ролей папок. В нем показаны уровни каждой роли и строка кода, возвращаемая REST API Power BI. Администратор — это самый высокий уровень разрешений рабочей области, а средство просмотра — наименьшее. Каждый уровень разрешений включает возможности указанных ниже разрешений. Вы можете просмотреть возможности каждого разрешения в ролях рабочей области.
| Роль папки | Уровень | Производные разрешения для семантических моделей, созданных в рабочей области |
|---|---|---|
| Администрирование | 4 | ReadWriteReshareExplore |
| Элемент | 3 | ReadWriteReshareExplore |
| Участник | 2 | ReadWriteExplore |
| Наблюдатель | 1 | Read |
Примечание.
Разрешение на запись применяется к семантическим моделям Power BI, созданным администратором, членом и участник пользователями в рабочей области, в которую они принадлежат. Разрешение на запись можно предоставить или удалить только с помощью разрешений рабочей области. Он не может быть предоставлен напрямую или удален из элемента Power BI.
Получение и добавление разрешений рабочей области с помощью API
Чтобы получить и добавить разрешения рабочей области программным способом, используйте следующие API:
Группы — добавление пользователя группы — API POST для добавления разрешений рабочей области
Группы — обновление пользователя группы — API PUT для изменения разрешений рабочей области
Группы — получение пользователей группы — API GET для получения разрешений рабочей области
Разрешения элемента
Элементы Power BI, такие как отчеты, семантические модели и панели мониторинга, имеют собственные разрешения. Разрешения элемента не могут переопределить разрешения рабочей области и могут предоставляться только тем, кто имеет по крайней мере тот же уровень разрешений.
Разрешения семантической модели и REST API
Разрешения семантической модели являются частью разрешений элемента. В таблице ниже перечислены разрешения семантической модели Power BI и их представление в REST API Power BI.
Совет
Хотя разрешения API идентичны разрешениям служба Power BI, build разрешения называются разрешениями для изучения в API.
Примечание.
Чтобы разрешить пользователю выполнять операции записи в семантической модели, сначала измените разрешения рабочей области.
Разрешения сборки и REST API
В REST APIbuild Power BI возвращается разрешение, как изучить. Например, строка с разрешениями на чтение, повторное использование и сборку будет выглядеть следующим образом: ReadReshareExplore
При получении разрешения пользователя build они могут создавать новое содержимое в семантической модели. Примерами содержимого, которые они могут создавать, являются отчеты, панели мониторинга, закрепленные плитки из Q&A, отчетов с разбивкой на страницы и обнаружение Аналитика.
Пользователям также требуются build разрешения на работу с данными за пределами Power BI:
Экспорт базовых данных.
Создание нового содержимого в семантической модели, например с помощью анализа в Excel.
Доступ к данным через конечную точку XMLA.
Безопасность на уровне строк
Для семантической модели, используюющей безопасность на уровне строк (RLS), все разрешения выше , чем build позволит пользователю просматривать все данные в семантической модели. Buildи разрешения ниже build, чем у пользователя семантической модели, доступ к данным, которые они могут видеть в параметрах RLS.
Получение и обновление разрешений семантической модели с помощью API
API POST позволяют добавлять новые разрешения в семантику модели. Эти API можно использовать для добавления разрешений для пользователей, но не для удаления разрешений. Например, можно добавить
Reshareразрешение для пользователя, имеющегоReadразрешение. Однако вы не можете удалитьReshareразрешение от пользователя, имеющего обаReadиReshareразрешения, пытаясь добавитьReadразрешение.API PUT обновляют разрешения пользователя на заданный набор данных. API PUT нельзя использовать для изменения разрешений записи или наследуемого уровня папок. Этот API также поддерживает удаление всех разрешений для набора данных для заданного целевого объекта.
API GET возвращают список субъектов, имеющих доступ к указанному набору данных.
Рекомендации и ограничения
Каждый из приведенных выше API имеет определенные ограничения относительно того, кто может их использовать и как. Чтобы просмотреть ограничения каждого API, выберите ссылку для этого API.
Связанный контент
- REST API Power BI.
- Отправка наборов данных.