Admin - Capacities GetCapacityUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste der Benutzer zurück, die Zugriff auf den angegebenen Arbeitsbereich haben.

Berechtigungen

• Der Benutzer muss über Administratorrechte verfügen (z. B. Office 365 globaler Administrator oder Power BI-Dienstadministrator).
• Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter dienstprinicipaler Authentifizierung dürfen für eine App keine erforderlichen Administratoreinwilligungsvoreinstellungen für Power BI im Azure-Portal festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/users

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
capacityId	path	True	string uuid	Die Kapazitäts-ID

Antworten

Name	Typ	Beschreibung
200 OK	CapacityUsers	OK

Definitionen

Name	Beschreibung
CapacityUser	Ein Power BI-Benutzerzugriffsrechteintrag für eine Kapazität
capacityUserAccessRight	Das Zugriffsrecht, das der Benutzer auf die Kapazität hat
CapacityUsers	Der OData-Antwort-Wrapper für eine Liste von Power BI-Benutzern mit Zugriff auf eine Kapazität
PrincipalType	Der Prinzipaltyp
ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

CapacityUser

Ein Power BI-Benutzerzugriffsrechteintrag für eine Kapazität

Name	Typ	Beschreibung
capacityUserAccessRight	capacityUserAccessRight	Das Zugriffsrecht, das der Benutzer auf die Kapazität hat
displayName	string	Anzeigename des Prinzipals
emailAddress	string	E-Mail-Adresse des Benutzers
graphId	string	Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.
identifier	string	Bezeichner des Prinzipals
principalType	PrincipalType	Der Prinzipaltyp
profile	ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
userType	string	Typ des Benutzers.

capacityUserAccessRight

Das Zugriffsrecht, das der Benutzer auf die Kapazität hat

Name	Typ	Beschreibung
Admin	string	Der Benutzer verfügt über Administratorrechte für die Kapazität.
Assign	string	Der Benutzer hat Mitwirkenderechte und kann arbeitsbereiche der Kapazität zuweisen.
None	string	Der Benutzer hat keinen Zugriff auf die Kapazität.

CapacityUsers

Der OData-Antwort-Wrapper für eine Liste von Power BI-Benutzern mit Zugriff auf eine Kapazität

Name	Typ	Beschreibung
odata.context	string
value	CapacityUser[]	Die Liste der Benutzer mit Zugriff auf eine Kapazität

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Verwenden Sie dies für den gesamten Zugriff auf Organisationsebene.
User	string	Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Name	Typ	Beschreibung
displayName	string	Der Dienstprinzipalprofilname
id	string	Die Dienstprinzipalprofil-ID