Admin - Users GetUserArtifactAccessAsAdmin
Belirtilen kullanıcının erişimi olan Power BI öğelerinin (raporlar veya panolar gibi) listesini döndürür.
İzinler
- Kullanıcının yönetici haklarına (Office 365 Genel Yönetici veya Power BI Hizmet Yöneticisi gibi) sahip olması veya hizmet sorumlusu kullanarak kimlik doğrulaması yapması gerekir.
- Temsilci izinleri desteklenir.
Gerekli Kapsam
Tenant.Read.All veya Tenant.ReadWrite.All
Sınırlamalar
Saatte en fazla 200 istek.
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}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
user
|
path | True |
string |
Kullanıcının grafik kimliği veya kullanıcı asıl adı (UPN) |
artifact
|
query |
string |
Yapıt türlerinin virgülle ayrılmış listesi. |
|
continuation
|
query |
string |
Sonuç kümesinin sonraki öbeklerini almak için gereken belirteç |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
Örnekler
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"
}
Tanımlar
Name | Description |
---|---|
Artifact |
Power BI öğesi için kullanıcı erişim girdisi |
Artifact |
Kullanıcının erişebileceği Power BI öğelerinin (raporlar veya panolar gibi) listesi için OData yanıt sarmalayıcısı |
Artifact |
Yapıt türü |
Principal |
Asıl tür |
Service |
Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir. |
User |
Power BI kullanıcısı |
ArtifactAccessEntry
Power BI öğesi için kullanıcı erişim girdisi
Name | Tür | Description |
---|---|---|
accessRight |
string |
Kullanıcının Power BI öğesi için sahip olduğu erişim hakkı |
artifactId |
string |
Power BI öğe kimliği |
artifactType |
Power BI öğesinin türü |
|
displayName |
string |
Power BI öğesinin görünen adı |
shareType |
string |
Erişimin Power BI öğesine nasıl verildiği. Yalnızca yaygın olarak paylaşılan yapıt API'leri için kullanılabilir. |
sharer |
Power BI öğesini paylaşan kullanıcı. Yalnızca yaygın olarak paylaşılan yapıt API'leri için kullanılabilir. |
ArtifactAccessResponse
Kullanıcının erişebileceği Power BI öğelerinin (raporlar veya panolar gibi) listesi için OData yanıt sarmalayıcısı
Name | Tür | Description |
---|---|---|
artifactAccessEntities |
Kullanıcının erişebileceği Power BI öğelerinin listesi |
|
continuationToken |
string |
Sonuç kümesindeki sonraki öbek için belirteç |
continuationUri |
string |
Sonuç kümesindeki bir sonraki öbeğin URI'si |
odata.context |
string |
ArtifactType
Yapıt türü
Name | Tür | Description |
---|---|---|
App |
string |
Power BI Uygulamaları |
Capacity |
string |
Capacity nesnesi |
Dashboard |
string |
Power BI Panosu |
Dataflow |
string |
Power BI Veri Akışı |
Dataset |
string |
Power BI Veri Kümesi |
Group |
string |
V1 paylaşılan çalışma alanı nesnesi |
PaginatedReport |
string |
Power BI Sayfalandırılmış Raporu |
PersonalGroup |
string |
Çalışma alanım nesnesi |
Report |
string |
Power BI Raporu |
Workspace |
string |
Paylaşılan çalışma alanı nesnesi |
PrincipalType
Asıl tür
Name | Tür | Description |
---|---|---|
App |
string |
Hizmet sorumlusu türü |
Group |
string |
Grup sorumlusu türü |
None |
string |
Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın. |
User |
string |
Kullanıcı asıl türü |
ServicePrincipalProfile
Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.
Name | Tür | Description |
---|---|---|
displayName |
string |
Hizmet sorumlusu profil adı |
id |
string |
Hizmet sorumlusu profil kimliği |
User
Power BI kullanıcısı
Name | Tür | Description |
---|---|---|
displayName |
string |
Sorumlunun görünen adı |
emailAddress |
string |
Kullanıcının e-posta adresi |
graphId |
string |
Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir. |
identifier |
string |
Sorumlunun tanımlayıcısı |
principalType |
Asıl tür |
|
profile |
Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir. |
|
userType |
string |
Kullanıcının türü. |