Admin - Groups AddUserAsAdmin

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Udělí uživatelům 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.

Povolení

Uživatel musí být správcem prostředků infrastruktury.

Požadovaný obor

Tenant.ReadWrite.All

Omezení

• Maximálně 200 požadavků za hodinu.
• Každý pracovní prostor je omezený na maximálně 1 000 uživatelů nebo skupin v rolích pracovního prostoru (správce, člen, přispěvatel, prohlížeč). Počet uživatelů v rámci skupiny není omezen. Omezení se týká také externích hostů.
  
  

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ávo (úroveň oprávnění), které má uživatel v pracovním 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 instančního objektu Power BI. Platí jenom pro víceklientské řešení Power BI Embedded.
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

Ukázkový požadavek

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

Text požadavku

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

Ukázková odpověď

Stavový kód:

200

Add service principal to workspace example

Ukázkový požadavek

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

Text požadavku

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

Ukázková odpověď

Stavový kód:

200

Add user to group example

Ukázkový požadavek

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

Text požadavku

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

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
GroupUser	Uživatel Power BI s přístupem k pracovnímu prostoru
GroupUserAccessRight	Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil instančního objektu Power BI. Platí jenom pro víceklientské řešení Power BI Embedded.

GroupUser

Objekt

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ávo (úroveň oprávnění), které má uživatel v pracovním prostoru
identifier	string	Identifikátor objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení
profile	ServicePrincipalProfile	Profil instančního objektu Power BI. Platí jenom pro víceklientské řešení Power BI Embedded.
userType	string	Typ uživatele

GroupUserAccessRight

Výčet

Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru

Hodnota	Description
None	Žádný přístup k obsahu pracovního prostoru
Member	Čtení, opětovné sdílení a zkoumání přístupových práv k obsahu pracovního prostoru (ReadReshareExplore)
Admin	Práva správce k obsahu pracovního prostoru
Contributor	Čtení a zkoumání přístupu (ReadExplore) k obsahu pracovního prostoru
Viewer	Přístup k obsahu pracovního prostoru jen pro čtení (jen pro čtení)

PrincipalType

Výčet

Typ objektu zabezpečení

Hodnota	Description
None	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	Typ objektu zabezpečení uživatele
Group	Typ objektu zabezpečení skupiny
App	Typ instančního objektu

ServicePrincipalProfile

Objekt

Profil instančního objektu Power BI. Platí jenom pro víceklientské řešení Power BI Embedded.

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