Sdílet prostřednictvím


Groups - Add Group User

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

Dovolení

Toto volání rozhraní API může volat instanční profil. Další informace najdete v tématu: profily instančního objektu v Power BI Embedded.

Požadovaný obor

Workspace.ReadWrite.All

Omezení

  • Aktualizace uživatelských oprávnění pro pracovní prostory chvíli trvá a při použití volání rozhraní API nemusí být okamžitě dostupná. Pokud chcete aktualizovat uživatelská oprávnění, použijte volání rozhraní API Aktualizovat uživatelská oprávnění.

POST https://api.powerbi.com/v1.0/myorg/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. Relevantní pouze pro víceklientské řešení Power BI Embedded.

userType

string

Typ uživatele

Odpovědi

Name Typ Description
200 OK

OK

Příklady

Assign administrator user access rights to a service principal example
Example

Assign administrator user access rights to a service principal example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Ukázková odpověď

Example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Ukázková odpověď

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. Relevantní pouze pro víceklientské řešení Power BI Embedded.

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á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. Relevantní pouze pro víceklientské řešení Power BI Embedded.

userType

string

Typ uživatele

GroupUserAccessRight

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

Hodnota Description
Admin

Práva správce k obsahu pracovního prostoru

Contributor

Čtení a zkoumání přístupu (ReadExplore) 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)

None

Žádný přístup k obsahu pracovního prostoru

Viewer

Přístup k obsahu pracovního prostoru jen pro čtení (jen pro čtení)

PrincipalType

Typ objektu zabezpečení

Hodnota Description
App

Typ instančního objektu

Group

Typ objektu zabezpečení skupiny

None

Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.

User

Typ objektu zabezpečení uživatele

ServicePrincipalProfile

Profil instančního objektu Power BI. Relevantní pouze 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