Sdílet prostřednictvím


Datasets - Put Dataset User In Group

Aktualizace stávající oprávnění datové sady zadaného uživatele k zadaným oprávněním.

Když se uživatelská oprávnění k datové sadě nedávno aktualizovala, nemusí být nová oprávnění okamžitě dostupná prostřednictvím volání rozhraní API. Pokud chcete aktualizovat uživatelská oprávnění, použijte volání rozhraní API pro aktualizace uživatelských oprávnění . Toto volání rozhraní API lze použít k odebrání všech oprávnění datové sady zadaného uživatele pomocí datasetUserAccessRight: None

Požadovaný obor

Dataset.ReadWrite.All

Oprávnění

Oprávnění pro toto volání rozhraní API jsou uvedená v oprávněních datových sad.

Omezení

  • Aktualizace oprávnění na instanční objekty (app principalType) se nepodporuje.
  • Volající musí mít oprávnění ReadWriteReshare k datové sadě. To znamená, že správci složek, členové a přispěvatelé s oprávněními Ke sdílení nebo vlastníci datových sad.
  • Toto rozhraní API se nedá použít k přidání nebo odebrání oprávnění k zápisu .
  • Toto rozhraní API se nedá použít k odebrání zděděných oprávnění na úrovni složky. U správců a členů složek se oprávnění ReadWriteReshareExplore u datových sad složky dědí. U přispěvatelů složek se zdědí oprávnění ReadWriteExplore u datových sad složky. U prohlížečů složek se zdědí oprávnění ke čtení datových sad složky.

PUT https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/users

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
path True

string

ID datové sady

groupId
path True

string

uuid

ID pracovního prostoru

Text požadavku

Name Vyžadováno Typ Description
datasetUserAccessRight True

DatasetUserAccessRight

Přístupová práva k přiřazení uživateli pro datovou sadu (úroveň oprávnění)

identifier True

string

Pro typ Userobjektu zabezpečení zadejte hlavní název uživatele ( UPN). V opačném případě zadejte ID objektu objektu.

principalType True

PrincipalType

Typ objektu zabezpečení

Odpovědi

Name Typ Description
200 OK

OK

Příklady

Example
Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Example for updating security group dataset permissions to ReadExplore

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Definice

Name Description
DatasetUserAccess

Správná položka přístupu k objektu zabezpečení Power BI pro datovou sadu

DatasetUserAccessRight

Přístupové právo, které má uživatel pro datovou sadu (úroveň oprávnění)

PrincipalType

Typ objektu zabezpečení

DatasetUserAccess

Správná položka přístupu k objektu zabezpečení Power BI pro datovou sadu

Name Typ Description
datasetUserAccessRight

DatasetUserAccessRight

Přístupová práva k přiřazení uživateli pro datovou sadu (úroveň oprávnění)

identifier

string

Pro typ Userobjektu zabezpečení zadejte hlavní název uživatele ( UPN). V opačném případě zadejte ID objektu objektu.

principalType

PrincipalType

Typ objektu zabezpečení

DatasetUserAccessRight

Přístupové právo, které má uživatel pro datovou sadu (úroveň oprávnění)

Name Typ Description
None

string

Odebere oprávnění k obsahu v datové sadě.

Read

string

Uděluje přístup pro čtení k obsahu v datové sadě.

ReadExplore

string

Uděluje přístup ke čtení a prozkoumání obsahu v datové sadě.

ReadReshare

string

Uděluje přístup ke čtení a opětovnému sdílení obsahu v datové sadě.

ReadReshareExplore

string

Uděluje oprávnění ke čtení, opětovnému sdílení a prozkoumání přístupu k obsahu v datové sadě.

ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v datové sadě.

ReadWriteExplore

string

Uděluje přístup ke čtení, zápisu a prozkoumání přístupu k obsahu v datové sadě.

ReadWriteReshare

string

Uděluje přístup ke čtení, zápisu a opětovnému sdílení obsahu v datové sadě.

ReadWriteReshareExplore

string

Uděluje přístup ke čtení, zápisu, opětovnému sdílení a prozkoumání přístupu k obsahu v datové sadě.

PrincipalType

Typ objektu zabezpečení

Name Typ Description
App

string

Typ instančního objektu

Group

string

Typ objektu zabezpečení skupiny

None

string

Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.

User

string

Typ objektu zabezpečení uživatele