Admin - Groups AddUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Uděluje uživatelská oprávnění k zadanému pracovnímu prostoru.

Toto volání rozhraní API podporuje pouze přidání uživatele, skupiny zabezpečení, skupiny M365 a instančního objektu.

Oprávnění

Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI).

Požadovaný obor

Tenant.ReadWrite.All

Omezení

Maximálně 200 požadavků za hodinu.

POST https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
groupId	path	True	string uuid	ID pracovního prostoru

Text požadavku

Name	Vyžadováno	Typ	Description
groupUserAccessRight	True	GroupUserAccessRight	Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu prostoru
identifier	True	string	Identifikátor objektu zabezpečení
principalType	True	PrincipalType	Typ objektu zabezpečení
displayName		string	Zobrazovaný název objektu zabezpečení
emailAddress		string	E-mailová adresa uživatele
graphId		string	Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
profile		ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType		string	Typ uživatele.

Odpovědi

Name	Typ	Description
200 OK		OK

Příklady

Add security group to workspace example

Add service principal to workspace example

Add user to group example

Add security group to workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

Sample Response

Status code:

200

Add service principal to workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

Sample Response

Status code:

200

Add user to group example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

Status code:

200

Definice

Name	Description
GroupUser	Uživatel Power BI s přístupem k pracovnímu prostoru
GroupUserAccessRight	Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu prostoru
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

GroupUser

Uživatel Power BI s přístupem k pracovnímu prostoru

Name	Typ	Description
displayName	string	Zobrazovaný název objektu zabezpečení
emailAddress	string	E-mailová adresa uživatele
graphId	string	Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
groupUserAccessRight	GroupUserAccessRight	Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu prostoru
identifier	string	Identifikátor objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení
profile	ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType	string	Typ uživatele.

GroupUserAccessRight

Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu prostoru

Name	Typ	Description
Admin	string	Práva správce k obsahu pracovního prostoru
Contributor	string	Čtení a zkoumání přístupu (ReadExplore) k obsahu pracovního prostoru
Member	string	Číst, sdílet a zkoumat přístupová práva (ReadReshareExplore) k obsahu pracovního prostoru
None	string	Žádný přístup k obsahu pracovního prostoru
Viewer	string	Přístup jen pro čtení k obsahu pracovního prostoru

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žijte pro přístup na úrovni celé organizace.
User	string	Typ objektu zabezpečení uživatele

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name	Typ	Description
displayName	string	Název profilu instančního objektu
id	string	ID profilu instančního objektu