Povolenia pre sémantický model REST API
Tento článok popisuje povolenia Power BI vo všeobecnosti a povolenia pre sémantický model v kontexte rozhraní REST API služby Power BI.
Povolenia Power BI
Power BI má dve množiny povolení:
Povolenia pracovného priestoru
Povolenia pracovného priestoru, známe aj ako povolenia priečinka alebo roly, predstavujú najvyššiu úroveň povolení v službe Power BI. Tieto povolenia prepíšu povolenia, ktoré sa dajú konkrétnej položke v priečinku pracovného priestoru.
V tabuľke nižšie sú uvedené štyri typy rolí priečinkov. Zobrazuje úroveň každej roly a reťazec kódu vrátený rozhraniami REST API služby Power BI. Spravovanie je najvyššia úroveň povolení pracovného priestoru a divák je najnižší. Každá úroveň povolení obsahuje možnosti povolení pod ňou. V rolách pracovného priestoru si môžete prezrieť možnosti jednotlivých povolení.
Rola priečinka | Úroveň | Odvodené povolenia pre sémantické modely vytvorené v pracovnom priestore |
---|---|---|
Správca | 4 | ReadWriteReshareExplore |
Člen | 3 | ReadWriteReshareExplore |
Prispievateľ | 2 | ReadWriteExplore |
Divák | 1 | Read |
Poznámka
Povolenie na zápis sa použije na sémantické modely služby Power BI vytvorené používateľmi z prostredia správcu, člena a prispievateľa v pracovnom priestore, ktorý vlastnia. Povolenie na zápis možno udeliť alebo odstrániť len pomocou povolení pracovného priestoru. Položku služby Power BI nemožno udeliť priamo položke služby Power BI ani z nej ju odstrániť.
Získanie a pridanie povolení pracovného priestoru pomocou rozhraní API
Ak chcete získať a pridať povolenia pracovného priestoru pomocou programovania, použite tieto rozhrania API:
Skupiny – Pridať používateľa skupiny – rozhranie API POST na pridanie povolení pracovného priestoru
Skupiny – aktualizovať používateľa skupiny – rozhranie API PUT na zmenu povolení pracovného priestoru
Skupiny – Získanie používateľov skupiny – rozhranie GET API na získanie povolení pre pracovný priestor
Povolenia pre položku
Položky Power BI, ako sú napríklad zostavy, sémantické modely a tabule, majú vlastné povolenia. Povolenia pre položku nemôžu prepísať povolenia pracovného priestoru a môže ich udeliť iba niekto, kto má aspoň rovnakú úroveň povolenia.
Povolenia pre sémantický model a rozhrania REST API
Povolenia sémantického modelu sú súčasťou povolení položiek. V tabuľke nižšie sa uvádzajú povolenia sémantického modelu služby Power BI a ich znázornenie v rozhraniach Power BI REST API.
Prepitné
Napriek tomu, že povolenia rozhrania API sú totožné s povoleniami služba Power BI, build
povolenia sa v rozhraniach API označujú ako povolenia na preskúmanie.
Povolenie | Prečítať | Preskúmať | Opakované zdieľanie |
---|---|---|---|
Description | Umožňuje používateľovi čítať obsah sémantického modelu | Ekvivalentné povolenia na vytváranie | Umožňuje používateľovi zdieľať obsah sémantického modelu s ostatnými používateľmi, ktorí pre neho získajú povolenia na čítanie, opätovné zdieľanie alebo preskúmanie povolení. |
ReadReshareExplore | |||
ČítaťZdieldeľovať | |||
ReadExplore | |||
Čítať |
Poznámka
Ak chcete povoliť používateľovi vykonávať operácie zapisovania v sémantickom modeli, najprv zmeňte povolenia pracovného priestoru.
Povolenia na vytváranie a rozhrania REST API
V rozhraniach build
Power BI REST API sa povolenie vráti pri skúmaní. Napríklad reťazec s povoleniami na čítanie, opätovné zdieľanie a vytváranie bude vyzerať takto: ReadReshareExplore
.
Keď používateľovi udelíte build
povolenie, môže v sémantickom modeli vytvárať nový obsah. Príkladom obsahu, ktorý môžu vytvárať, sú zostavy, tabule, pripnuté dlaždice z Q&A, stránkovaných zostáv a Prehľady Discovery.
Používatelia tiež potrebujú build
povolenia na prácu s údajmi mimo Power BI:
Na exportovanie základných údajov.
Na vytváranie nového obsahu v sémantickom modeli, napríklad pomocou funkcie Analyzovať v Exceli.
Na prístup k údajom prostredníctvom koncového bodu XMLA.
Zabezpečenie na úrovni riadkov
Pre sémantický model, ktorý používa zabezpečenie na úrovni riadkov (RLS), všetky povolenia vyššie , ako build
umožnia používateľovi zobraziť všetky údaje v sémantickom modeli. Build
a povolenia nižšie ako build
– udeľujú používateľovi sémantického modelu iba prístup k údajom, ktoré mu môžu zobrazovať tak, ako je to nakonfigurované v nastaveniach zabezpečenia na úrovni riadkov.
Získanie a aktualizácia povolení sémantického modelu pomocou rozhraní API
Post API umožňuje pridávať nové povolenia do sémantického modelu. Tieto rozhrania API môžete použiť na pridanie povolení pre používateľov, ale nie na odstránenie povolení. Môžete napríklad pridať
Reshare
povolenie používateľovi, ktorý má povolenieRead
. Pokusom o pridanieReshare
Read
povolenia však nemôžete odstrániť povolenie od používateľa, ktorý má povolenia ajRead
Reshare
povolenia.Rozhrania PUT API aktualizujú povolenia používateľa pre danú množinu údajov. Rozhranie PUT API sa nedá použiť na zmenu povolení na zápis ani na akúkoľvek zdedené povolenia na úrovni priečinka. Toto rozhranie API tiež podporuje odstránenie všetkých povolení pre množinu údajov pre daný cieľ.
Rozhrania GET API vrátia zoznam objektov, ktoré majú prístup k zadanej množine údajov.
Dôležité informácie a obmedzenia
Každé z vyššie uvedených rozhraní API má určité obmedzenia týkajúce sa toho, kto ich môže používať a ako. Ak chcete zobraziť obmedzenia jednotlivých rozhraní API, vyberte prepojenie pre dané rozhranie API.