Groups - Get Group Users

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Mengembalikan daftar pengguna yang memiliki akses ke ruang kerja yang ditentukan.

Izin

Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Workspace.Read.All atau Workspace.ReadWrite.All

Batasan

Izin pengguna untuk ruang kerja membutuhkan waktu untuk diperbarui dan mungkin tidak segera tersedia saat menggunakan panggilan API. Untuk merefresh izin pengguna, gunakan panggilan REFRESH USER Permissions API.

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users?$top={$top}&$skip={$skip}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
groupId	path	True	string uuid	ID ruang kerja
$skip	query		integer int32	Melompati hasil n pertama
$top	query		integer int32	Mengembalikan hanya hasil n pertama

Respons

Nama	Jenis	Deskripsi
200 OK	GroupUsers	OK

Contoh

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definisi

Nama	Deskripsi
GroupUser	Pengguna Power BI dengan akses ke ruang kerja
GroupUserAccessRight	Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja
GroupUsers	Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke ruang kerja
PrincipalType	Jenis utama
ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

GroupUser

Pengguna Power BI dengan akses ke ruang kerja

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama
emailAddress	string	Alamat email pengguna
graphId	string	Pengidentifikasi utama di Microsoft Graph. Hanya tersedia untuk API admin.
groupUserAccessRight	GroupUserAccessRight	Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja
identifier	string	Pengidentifikasi utama
principalType	PrincipalType	Jenis utama
profile	ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.
userType	string	Jenis pengguna.

GroupUserAccessRight

Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja

Nama	Jenis	Deskripsi
Admin	string	Hak administrator untuk konten ruang kerja
Contributor	string	Akses baca dan jelajahi (ReadExplore) ke konten ruang kerja
Member	string	Membaca, membentuk ulang, dan menjelajahi hak akses (ReadReshareExplore) ke konten ruang kerja
None	string	Tidak ada akses ke konten ruang kerja
Viewer	string	Akses baca-saja (Baca) ke konten ruang kerja

GroupUsers

Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke ruang kerja

Nama	Jenis	Deskripsi
odata.context	string
value	GroupUser[]	Daftar pengguna dengan akses ke ruang kerja

PrincipalType

Jenis utama

Nama	Jenis	Deskripsi
App	string	Jenis perwakilan layanan
Group	string	Jenis prinsipal grup
None	string	Tidak ada jenis utama. Gunakan untuk akses tingkat seluruh organisasi.
User	string	Jenis prinsipal pengguna

ServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

Nama	Jenis	Deskripsi
displayName	string	Nama profil perwakilan layanan
id	string	ID profil perwakilan layanan

Bagikan melalui