Admin - Apps GetAppUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Vrátí seznam uživatelů, kteří mají přístup k zadané aplikaci.

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) nebo ověřování pomocí instančního objektu.
• Delegovaná oprávnění jsou podporovaná.

Při spuštění v rámci původního ověřování služby nesmí mít aplikace v Azure Portal nastavené žádné předpoklady vyžadované správcem pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Nesmí být k dispozici při použití ověřování prostřednictvím instančního objektu.

Omezení

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

GET https://api.powerbi.com/v1.0/myorg/admin/apps/{appId}/users

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
appId	path	True	string uuid	ID aplikace

Odpovědi

Name	Typ	Description
200 OK	AppUsers	OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Sample Response

Status code:

200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definice

Name	Description
AppUser	Položka přístupového práva uživatele Power BI pro aplikaci
AppUserAccessRight	Přístupové právo, které má uživatel k aplikaci
AppUsers	Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k aplikaci
PrincipalType	Typ objektu zabezpečení

AppUser

Položka přístupového práva uživatele Power BI pro aplikaci

Name	Typ	Description
appUserAccessRight	AppUserAccessRight	Přístupové právo, které má uživatel k aplikaci
displayName	string	Zobrazovaný název objektu zabezpečení
emailAddress	string	E-mailová adresa uživatele
graphId	string	Identifikátor objektu zabezpečení v Microsoft Graph. K dispozici pouze pro rozhraní API pro správu.
identifier	string	Identifikátor objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení

AppUserAccessRight

Přístupové právo, které má uživatel k aplikaci

Name	Typ	Description
All	string	Uděluje přístup ke čtení, zápisu, prozkoumání, opětovnému sdílení a kopírování obsahu v aplikaci.
None	string	Žádná oprávnění k obsahu v aplikaci
Read	string	Uděluje přístup ke čtení obsahu v aplikaci.
ReadCopy	string	Uděluje přístup ke čtení a kopírování obsahu v aplikaci.
ReadExplore	string	Uděluje přístup ke čtení a prozkoumání obsahu v aplikaci.
ReadExploreCopy	string	Uděluje přístup ke čtení, prozkoumání a kopírování obsahu v aplikaci.
ReadReshare	string	Uděluje oprávnění ke čtení a opětovnému sdílení obsahu v aplikaci.
ReadReshareCopy	string	Uděluje přístup ke čtení, sdílení a kopírování obsahu v aplikaci.
ReadReshareExplore	string	Uděluje přístup ke čtení, sdílení a prozkoumání obsahu v aplikaci.
ReadReshareExploreCopy	string	Uděluje přístup ke čtení, sdílení, prozkoumání a kopírování obsahu v aplikaci.
ReadWrite	string	Uděluje přístup ke čtení a zápisu k obsahu v aplikaci.
ReadWriteExplore	string	Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v aplikaci.
ReadWriteExploreCopy	string	Uděluje přístup ke čtení, zápisu, prozkoumání a kopírování obsahu v aplikaci.
ReadWriteReshare	string	Uděluje přístup ke čtení, zápisu a sdílení obsahu v aplikaci.
ReadWriteReshareExplore	string	Uděluje přístup ke čtení, zápisu, sdílení a prozkoumání obsahu v aplikaci.

AppUsers

Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k aplikaci

Name	Typ	Description
odata.context	string
value	AppUser[]	Seznam uživatelů s přístupem k aplikaci

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