Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

Udělí zadanému uživateli oprávnění k zadané datové sadě.

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í .

Požadovaný obor

Dataset.ReadWrite.All

Omezení

• Přidání oprávnění k instančním objektům (app principalType) se nepodporuje.
• Volající musí mít pro datovou sadu oprávnění ReadReshare.
• Toto volání rozhraní API nejde použít k udělení oprávnění k zápisu datové sady pro datovou sadu.
  
  

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/users

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady

Text požadavku

Name	Vyžadováno	Typ	Description
datasetUserAccessRight	True	DatasetUserAccessRightEntry	Povinná hodnota. Přístupové právo k udělení uživateli pro datovou sadu
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 granting ReadExplore right to a security group

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

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

Sample Response

Status code:

200

Example for granting ReadExplore right to a security group

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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
DatasetUserAccessRightEntry	Povinná hodnota. Přístupové právo k udělení uživateli pro datovou sadu
PostDatasetUserAccess	Přístup uživatele Power BI ke správné položce datové sady
PrincipalType	Typ objektu zabezpečení

DatasetUserAccessRightEntry

Povinná hodnota. Přístupové právo k udělení uživateli pro datovou sadu

Name	Typ	Description
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ě.

PostDatasetUserAccess

Přístup uživatele Power BI ke správné položce datové sady

Name	Typ	Description
datasetUserAccessRight	DatasetUserAccessRightEntry	Povinná hodnota. Přístupové právo k udělení uživateli pro datovou sadu
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í

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