Datasets - Get Dataset Users

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Vrátí seznam objektů zabezpečení, které mají přístup 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í .

Oprávnění

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

Požadovaný obor

Dataset.Read.All nebo Dataset.ReadWrite.All

Omezení

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.

GET 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

Odpovědi

Name	Typ	Description
200 OK	DatasetUsersAccess	OK

Příklady

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

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í)
DatasetUsersAccess	Obálka odpovědi OData pro seznam objektů zabezpečení Power BI s přístupem k datové sadě
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 `User`objektu 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ě.

DatasetUsersAccess

Obálka odpovědi OData pro seznam objektů zabezpečení Power BI s přístupem k datové sadě

Name	Typ	Description
odata.context	string
value	DatasetUserAccess[]	Seznam uživatelů s přístupem k 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

Share via