Admin - Apps GetAppUsersAsAdmin

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Mengembalikan daftar pengguna yang memiliki akses ke aplikasi yang ditentukan.

Izin

Pengguna harus memiliki hak administrator (seperti Office 365 Administrator Global atau Administrator Layanan Power BI) atau mengautentikasi menggunakan perwakilan layanan.
Izin yang didelegasikan didukung.

Saat berjalan di bawah autentikasi perwakilan layanan, aplikasi tidak boleh memiliki izin admin yang diperlukan untuk Power BI yang diatur di dalam portal Azure.

Cakupan yang Diperlukan

Tenant.Read.All atau Tenant.ReadWrite.All

Hanya relevan saat mengautentikasi melalui token akses admin standar yang didelegasikan. Tidak boleh ada ketika autentikasi melalui perwakilan layanan digunakan.

Batasan

Maksimum 200 permintaan per jam.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
appId	path	True	string uuid	ID aplikasi

Respons

Nama	Jenis	Deskripsi
200 OK	AppUsers	OK

Contoh

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"
    }
  ]
}

Definisi

Nama	Deskripsi
AppUser	Entri kanan akses pengguna Power BI untuk aplikasi
AppUserAccessRight	Hak akses yang dimiliki pengguna untuk aplikasi
AppUsers	Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke aplikasi
PrincipalType	Jenis utama

AppUser

Entri kanan akses pengguna Power BI untuk aplikasi

Nama	Jenis	Deskripsi
appUserAccessRight	AppUserAccessRight	Hak akses yang dimiliki pengguna untuk aplikasi
displayName	string	Nama tampilan prinsipal
emailAddress	string	Alamat email pengguna
graphId	string	Pengidentifikasi prinsipal dalam grafik Microsoft. Hanya tersedia untuk API admin.
identifier	string	Pengidentifikasi prinsipal
principalType	PrincipalType	Jenis utama

AppUserAccessRight

Hak akses yang dimiliki pengguna untuk aplikasi

Nama	Jenis	Deskripsi
All	string	Memberikan akses Baca, Tulis, Jelajahi, Reshare, dan Salin ke konten di aplikasi
None	string	Tidak ada izin ke konten di aplikasi
Read	string	Memberikan akses Baca ke konten di aplikasi
ReadCopy	string	Memberikan akses Baca dan Salin ke konten di aplikasi
ReadExplore	string	Memberikan akses Baca dan Jelajahi ke konten di aplikasi
ReadExploreCopy	string	Memberikan akses Baca, Jelajahi, dan Salin ke konten di aplikasi
ReadReshare	string	Memberikan akses Baca dan Reshare ke konten di aplikasi
ReadReshareCopy	string	Memberikan akses Baca, Reshare, dan Salin ke konten di aplikasi
ReadReshareExplore	string	Memberikan akses Baca, Reshare, dan Jelajahi konten di aplikasi
ReadReshareExploreCopy	string	Memberikan akses Baca, Reshare, Jelajahi, dan Salin ke konten di aplikasi
ReadWrite	string	Memberikan akses Baca dan Tulis ke konten di aplikasi
ReadWriteExplore	string	Memberikan akses Baca, Tulis, dan Jelajahi ke konten di aplikasi
ReadWriteExploreCopy	string	Memberikan akses Baca, Tulis, Jelajahi, dan Salin ke konten di aplikasi
ReadWriteReshare	string	Memberikan akses Baca, Tulis, dan Reshare ke konten di aplikasi
ReadWriteReshareExplore	string	Memberikan akses Baca, Tulis, Reshare, dan Jelajahi ke konten di aplikasi

AppUsers

Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke aplikasi

Nama	Jenis	Deskripsi
odata.context	string
value	AppUser[]	Daftar pengguna dengan akses ke aplikasi

PrincipalType

Jenis utama

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

Bagikan melalui