Datasets - Put Dataset User In Group

Service:

Power BI REST APIs

API Version:

v1.0

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

Request Body

{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:

200

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

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:

200

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