Semanttisen mallin REST-ohjelmointirajapinnan käyttöoikeudet

Tässä artikkelissa kuvataan Power BI -käyttöoikeuksia yleisesti ja semanttisia mallin käyttöoikeuksia Power BI REST -ohjelmointirajapintojen kontekstissa.

Power BI -käyttöoikeudet

Power BI:ssä on kaksi käyttöoikeusjoukkoa:

• Työtilan käyttöoikeudet

• Kohteen käyttöoikeudet

Työtilan käyttöoikeudet

Työtilan käyttöoikeudet, joita kutsutaan myös kansioiden käyttöoikeuksiksi tai rooleiksi, ovat Power BI:n korkeimmat käyttöoikeudet. Nämä oikeudet ohittavat käyttöoikeudet, jotka on annettu tietylle työtilakansion kohteelle.

Alla olevassa taulukossa on lueteltu neljä kansioroolityyppiä. Se näyttää kunkin roolin tason ja Power BI REST -ohjelmointirajapintojen palauttaman koodimerkkijonon. Hallinta on työtilan korkein käyttöoikeustaso ja katselija pienin. Jokainen käyttöoikeustaso sisältää sen alla olevien käyttöoikeuksien ominaisuudet. Voit tarkastella kunkin käyttöoikeuden ominaisuuksia työtilarooleissa.

Kansiorooli	Taso	Työtilassa luotujen semanttisten mallien johdetut käyttöoikeudet
Järjestelmänvalvoja	4	ReadWriteReshareExplore
Jäsen	3	ReadWriteReshareExplore
Osallistuja	2	ReadWriteExplore
Katselija	1	Read

Muistiinpano

Kirjoitusoikeus koskee Power BI:n semanttisia malleja, jotka ovat järjestelmänvalvojan, jäsenen ja osallistujan käyttäjien luomia omistamassaan työtilassa. Kirjoitusoikeus voidaan myöntää tai poistaa vain työtilan käyttöoikeuksilla. Sitä ei voi suoraan myöntää Power BI -kohteelle tai poistaa siitä.

Työtilan käyttöoikeuksien hankkiminen ja lisääminen ohjelmointirajapinnoilla

Voit hankkia ja lisätä työtilan käyttöoikeuksia ohjelmallisesti seuraavien ohjelmointirajapintojen avulla:

• Ryhmät – Lisää ryhmän käyttäjä – POST-ohjelmointirajapinta työtilan käyttöoikeuksien lisäämiseksi

• Ryhmät – Päivitä ryhmän käyttäjä – A PUT-ohjelmointirajapinta työtilan käyttöoikeuksien muuttamiseen

• Ryhmät – Hae ryhmän käyttäjät – A GET API for getting workspace permissions

Kohteen käyttöoikeudet

Power BI -kohteilla, kuten raporteilla, semanttisella mallilla ja koontinäytöllä, on omat käyttöoikeutensa. Kohteen käyttöoikeudet eivät voi ohittaa työtilan käyttöoikeuksia, ja sen voi myöntää vain henkilö, jolla on vähintään samantasoinen käyttöoikeus.

Semanttisen mallin käyttöoikeudet ja REST-ohjelmointirajapinnat

Semanttisen mallin käyttöoikeudet ovat osa kohteen käyttöoikeuksia. Alla olevassa taulukossa on luettelo Power BI:n semanttisista mallin käyttöoikeuksista ja niiden esittämisestä Power BI REST -ohjelmointirajapinnoissa.

Vihje

Vaikka ohjelmointirajapinnan käyttöoikeudet ovat samat kuin Power BI -palvelu käyttöoikeudet, build käyttöoikeuksia kutsutaan ohjelmointirajapintojen tutkimisoikeuksilla.

Käyttöoikeus	Lue	Tutustuminen	Jaa uudelleen
Kuvaus	Sallii käyttäjän lukea semanttisen mallin sisältöä	Vastaa muodostamisoikeuksia	Sallii käyttäjän jakaa semanttisen mallin sisällön muiden käyttäjien kanssa, jotka saavat lukemisen, uudelleenjakamisen tai sen käyttöoikeuksien tutkimisen
ReadReshareExplore
ReadReshare
ReadExplore
Lue

Muistiinpano

Jos haluat sallia käyttäjän suorittaa kirjoitustoimintoja semanttisessa mallissa, muuta ensin työtilan käyttöoikeuksia.

Muodostamisoikeudet ja REST-ohjelmointirajapinnat

Power BI REST -ohjelmointirajapituissa buildkäyttöoikeus palautetaan tutkiessasi. Esimerkiksi merkkijono, jolla on luku-, uudelleenjakamis- ja muodostamisoikeudet, näyttää tältä: ReadReshareExplore.

Kun annat käyttäjälle build käyttöoikeuden, he voivat luoda uutta sisältöä semanttisen mallisi pohjalta. Esimerkkejä heidän käyttämästään sisällöstä ovat raportit, koontinäytöt, Q&A:sta kiinnitetyt ruudut, sivutetut raportit ja merkityksellisten tietojen haku.

Käyttäjillä on myös oltava build oikeudet käsitellä tietoja Power BI:n ulkopuolella:

• Pohjana olevien tietojen vieminen.

• Uuden sisällön luominen semanttiseen malliin, kuten Analysoi Excelissä -toiminnolla.

• Tietojen käyttäminen XMLA-päätepisteen kautta.

Rivitason suojaus

Jos semanttinen malli käyttää rivitason suojausta (RLS), mitkä tahansa korkeammat build käyttöoikeudet antavat käyttäjälle mahdollisuuden tarkastella kaikkia semanttisen mallin tietoja. Buildja käyttöoikeudet, jotka ovat pienempiä kuin build, antavat semanttisen mallin käyttäjälle vain niiden tietojen käyttöoikeuden, jotka hän saa nähdä RLS-asetuksissa määritetyllä tavalla.

Semanttisen mallin käyttöoikeuksien hankkiminen ja päivittäminen ohjelmointirajapinnoilla

• POST-ohjelmointirajapintojen avulla voit lisätä uusia käyttöoikeuksia semanttiseen malliin. Näiden ohjelmointirajapintojen avulla voit lisätä käyttöoikeuksia käyttäjille, mutta et poistaa käyttöoikeuksia. Voit esimerkiksi lisätä Reshare käyttöoikeuden käyttäjälle, jolla on Read käyttöoikeus. Et kuitenkaan voi poistaa Reshare käyttöoikeutta käyttäjältä, jolla on sekä ReadReshare - että -käyttöoikeudet, yrittämällä lisätä Read käyttöoikeuden.

  • Tietojoukot – Julkaise tietojoukon käyttäjä
  • Tietojoukot – Julkaise tietojoukon käyttäjä ryhmään

• PUT-ohjelmointirajapinnat päivittävät käyttäjän käyttöoikeudet tiettyyn tietojoukkoon. PUT-ohjelmointirajapintaa ei voi käyttää kirjoitusoikeuksien muuttamiseen tai mihinkään kansiotason perittyihin käyttöoikeuksiin. Tämä ohjelmointirajapinta tukee myös tietojoukon kaikkien käyttöoikeuksien poistamista tietystä kohteesta.

  • Tietojoukot – Sijoita tietojoukon käyttäjä
  • Tietojoukot – Siirrä tietojoukon käyttäjä ryhmään

• GET-ohjelmointirajapinnat palauttavat luettelon päänimistä, joilla on käyttöoikeus määritettyyn tietojoukkoon.

  • Tietojoukot – Hae tietojoukon käyttäjät
  • Tietojoukot – Hae tietojoukon käyttäjät ryhmään

Huomioitavat asiat ja rajoitukset

Kuhunkin yllä mainituista ohjelmointirajapinnoista liittyy tiettyjä rajoituksia sen suhteen, kuka niitä voi käyttää ja miten. Jos haluat tarkastella kunkin ohjelmointirajapinnan rajoituksia, valitse kyseisen ohjelmointirajapinnan linkki.

Liittyvä sisältö

• Power BI REST -ohjelmointirajapinnat.
• Push-tietojoukot.