Admin - Users GetUserArtifactAccessAsAdmin
Mengembalikan daftar item Power BI (seperti laporan atau dasbor) yang dapat diakses pengguna 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.
Cakupan yang Diperlukan
Tenant.Read.All atau Tenant.ReadWrite.All
Batasan
Maksimum 200 permintaan per jam.
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
user
|
path | True |
string |
ID grafik atau nama prinsipal pengguna (UPN) pengguna |
artifact
|
query |
string |
Daftar jenis artefak yang dipisahkan koma. |
|
continuation
|
query |
string |
Token diperlukan untuk mendapatkan potongan set hasil berikutnya |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
Contoh
Example |
Example with artifact |
Example with Guest User |
Example with UPN |
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess
Sample Response
{
"artifactAccessEntities": [
{
"artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
"displayName": "test report",
"artifactType": "Report",
"accessRight": "ReadWrite"
}
],
"continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
"continuationToken": "LDEsMTAwMDAwLDA%3D"
}
Example with artifactTypes
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess?artifactTypes=Dataflow,Dashboard
Sample Response
{
"artifactAccessEntities": [
{
"artifactId": "09ce06d1-e81b-fea0-1c6d-8fe3dd2f8e87",
"displayName": "Test Dataflow",
"artifactType": "Dataflow",
"accessRight": "ReadWrite"
}
],
"continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
"continuationToken": "LDEsMTAwMDAwLDA%3D"
}
Example with Guest User
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23@contoso.com/artifactAccess
Sample Response
{
"artifactAccessEntities": [
{
"artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
"displayName": "test report",
"artifactType": "Report",
"accessRight": "ReadWrite"
}
],
"continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23%40contoso.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
"continuationToken": "LDEsMTAwMDAwLDA%3D"
}
Example with UPN
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess
Sample Response
{
"artifactAccessEntities": [
{
"artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
"displayName": "test report",
"artifactType": "Report",
"accessRight": "ReadWrite"
}
],
"continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
"continuationToken": "LDEsMTAwMDAwLDA%3D"
}
Definisi
Nama | Deskripsi |
---|---|
Artifact |
Entri akses pengguna untuk item Power BI |
Artifact |
Pembungkus respons OData untuk daftar item Power BI (seperti laporan atau dasbor) yang bisa diakses pengguna |
Artifact |
Jenis artefak |
Principal |
Jenis utama |
Service |
Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded. |
User |
Pengguna Power BI |
ArtifactAccessEntry
Entri akses pengguna untuk item Power BI
Nama | Jenis | Deskripsi |
---|---|---|
accessRight |
string |
Hak akses yang dimiliki pengguna untuk item Power BI |
artifactId |
string |
The Power BI item ID |
artifactType |
Tipe item Power BI |
|
displayName |
string |
Nama tampilan item Power BI |
shareType |
string |
Jenis bagaimana akses diberikan ke item Power BI. Hanya tersedia untuk API artefak yang dibagikan secara luas. |
sharer |
Pengguna yang berbagi item Power BI. Hanya tersedia untuk API artefak yang dibagikan secara luas. |
ArtifactAccessResponse
Pembungkus respons OData untuk daftar item Power BI (seperti laporan atau dasbor) yang bisa diakses pengguna
Nama | Jenis | Deskripsi |
---|---|---|
artifactAccessEntities |
Daftar item Power BI yang bisa diakses pengguna |
|
continuationToken |
string |
Token untuk gugus berikutnya dalam tataan hasil |
continuationUri |
string |
URI gugus berikutnya dalam tataan hasil |
odata.context |
string |
ArtifactType
Jenis artefak
Nama | Jenis | Deskripsi |
---|---|---|
App |
string |
Aplikasi Power BI |
Capacity |
string |
Objek kapasitas |
Dashboard |
string |
Dasbor Power BI |
Dataflow |
string |
Aliran Data Power BI |
Dataset |
string |
Himpunan Data Power BI |
Group |
string |
Objek ruang kerja bersama V1 |
PaginatedReport |
string |
Laporan Paginasi Power BI |
PersonalGroup |
string |
Objek ruang kerja saya |
Report |
string |
Laporan Power BI |
Workspace |
string |
Objek ruang kerja bersama |
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 |
ServicePrincipalProfile
Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.
Nama | Jenis | Deskripsi |
---|---|---|
displayName |
string |
Nama profil perwakilan layanan |
id |
string |
ID profil perwakilan layanan |
User
Pengguna Power BI
Nama | Jenis | Deskripsi |
---|---|---|
displayName |
string |
Nama tampilan prinsipal |
emailAddress |
string |
Alamat email pengguna |
graphId |
string |
Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin. |
identifier |
string |
Pengidentifikasi prinsipal |
principalType |
Jenis utama |
|
profile |
Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded. |
|
userType |
string |
Jenis pengguna. |