語意模型 REST API 許可權

  • 發行項

本文說明 Power BI 許可權一般，以及 Power BI REST API 內容中的語意模型許可權。

Power BI 許可權

Power BI 有兩組許可權：

工作區權限

工作區許可權，也稱為資料夾許可權或 角色，是 Power BI 中最高層級的許可權。 這些許可權會覆寫工作區資料夾中特定項目的許可權。

下表列出四種類型的資料夾角色。 它會顯示每個角色的層級，以及 Power BI REST API 所傳回的程式代碼字串。 管理員 是最高的工作區許可權等級，而查看器是最低的。 每個許可權等級都包含其下方許可權的功能。 您可以檢閱工作區角色中每個許可權的功能。

資料夾角色 等級 工作區中建立之語意模型的衍生許可權
管理 4 ReadWriteReshareExplore
member 3 ReadWriteReshareExplore
參與者 2 ReadWriteExplore
檢視者 1 Read

注意

寫入許可權會套用至系統管理員、成員和參與者使用者在自己擁有工作區中建立的Power BI語意模型。 只能使用工作區許可權來授與或刪除寫入許可權。 它無法直接授與或刪除Power BI專案。

使用 API 取得和新增工作區許可權

若要以程式設計方式取得和新增工作區許可權，請使用下列 API：

項目權限

Power BI 專案，例如報表、語意模型和儀錶板都有自己的許可權。 專案許可權無法覆寫工作區許可權，而且只能由至少具有相同許可權層級的人員授與。

語意模型許可權和 REST API

語意模型許可權是項目許可權的一部分。 下表列出 Power BI 語意模型許可權及其在 Power BI REST API 中的表示法。

提示

雖然 API 許可權與 Power BI 服務 許可權相同，build但許可權稱為 API 中的探索許可權。

權限 參閱 瀏覽 Reshare
描述 允許使用者讀取語意模型的內容 相當於 建置許可權 允許使用者與將讀取、重新共用或探索其許可權的其他用戶共用語意模型的內容
ReadReshareExplore
ReadReshare
ReadExplore
讀取

注意

若要允許使用者對語意模型執行寫入作業，請先變更 工作區許可權。

建置許可權和 REST API

在 Power BI REST API 中，build許可權會以探索的形式傳回。 例如，具有讀取、重新共用和建置許可權的字串看起來會像這樣：ReadReshareExplore。

當您授與用戶 build 許可權時，他們可以在語意模型上建置新的內容。 他們可以建置的內容範例包括來自Q&A、編頁報表和深入解析探索的報表、儀錶板、釘選磚。

使用者也需要 build 權限才能在 Power BI 外部使用資料：

  • 匯出基礎數據。

  • 若要在語意模型上建置新內容，例如使用 [在 Excel 中進行分析]。

  • 若要透過 XMLA 端點存取資料。

資料列層級安全性

對於使用數據列層級安全性的語意模型 （RLS），任何高於build 的許可權都會讓用戶檢視語意模型中的所有數據。 Build和低於 build的許可權只會授與語意模型使用者存取其允許在 RLS 設定中所設定的數據。

使用 API 取得和更新語意模型許可權

考量與限制

上述每個 API 都有一些關於誰可以使用這些 API 以及其使用方式的一些限制。 若要查看每個 API 的限制，請選取該 API 的連結。

相關內容