Разрешения 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.

Разрешение	Читать	Анализ	Reshare
Description	Позволяет пользователю считывать содержимое семантической модели	Эквивалент разрешений сборки	Позволяет пользователю предоставлять общий доступ к содержимому семантической модели другим пользователям, которые получат разрешения на чтение, повторное использование или просмотр разрешений для него
ReadReshareExplore
ReadReshare
ReadExplore
Чтение

Примечание.

Чтобы разрешить пользователю выполнять операции записи в семантической модели, сначала измените разрешения рабочей области.

Разрешения сборки и 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 разрешение.

  • Наборы данных — пользователь набора данных post
  • Наборы данных — пользователь набора данных после записи в группу

• API PUT обновляют разрешения пользователя на заданный набор данных. API PUT нельзя использовать для изменения разрешений записи или наследуемого уровня папок. Этот API также поддерживает удаление всех разрешений для набора данных для заданного целевого объекта.

  • Наборы данных — поместить пользователя набора данных
  • Наборы данных — поместить пользователя набора данных в группу

• API GET возвращают список субъектов, имеющих доступ к указанному набору данных.

  • Наборы данных — получение пользователей набора данных
  • Наборы данных — получение пользователей набора данных в группе

Рекомендации и ограничения

Каждый из приведенных выше API имеет определенные ограничения относительно того, кто может их использовать и как. Чтобы просмотреть ограничения каждого API, выберите ссылку для этого API.

Связанный контент

• REST API Power BI.
• Отправка наборов данных.