Admin - Dashboards GetDashboardsAsAdmin
Kuruluşa ait panoların 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.
Hizmet özel kimlik doğrulaması altında çalıştırılırken, bir uygulamanın Azure portal Power BI için yönetici onayı için gerekli izinlere sahip olmaması gerekir.
Gerekli Kapsam
Tenant.Read.All veya Tenant.ReadWrite.All
Yalnızca standart bir yönetici temsilcisi erişim belirteci aracılığıyla kimlik doğrulaması yaparken geçerlidir. Hizmet sorumlusu aracılığıyla kimlik doğrulaması kullanıldığında mevcut olmamalıdır.
Sınırlamalar
Kiracı başına saatte en fazla 50 istek veya dakikada 5 istek.
GET https://api.powerbi.com/v1.0/myorg/admin/dashboards
GET https://api.powerbi.com/v1.0/myorg/admin/dashboards?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
$expand
|
query |
string |
Yanıtta satır içi olarak genişletilecek veri türlerinin virgülle ayrılmış listesini kabul eder. destekler |
|
$filter
|
query |
string |
Boole koşuluna göre sonuçları filtreler |
|
$skip
|
query |
integer int32 |
İlk n sonucu atlar |
|
$top
|
query |
integer int32 |
Yalnızca ilk n sonucu döndürür |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
Örnekler
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/dashboards
Sample Response
{
"value": [
{
"id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
"displayName": "SalesMarketing",
"embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
"isReadOnly": false,
"workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
}
]
}
Tanımlar
Name | Description |
---|---|
Admin |
Yönetici API'leri tarafından döndürülen bir Power BI panosu. API, aşağıdaki pano özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır. |
Admin |
Power BI pano koleksiyonu için OData yanıt sarmalayıcısı |
Admin |
Yönetici API'leri tarafından döndürülen bir Power BI kutucuğu. |
Dashboard |
Power BI kullanıcısı bir pano için doğru erişime sahip giriş |
Dashboard |
Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi) |
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. |
Subscription |
Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği |
Subscription |
Power BI e-posta aboneliği kullanıcısı |
AdminDashboard
Yönetici API'leri tarafından döndürülen bir Power BI panosu. API, aşağıdaki pano özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.
Name | Tür | Description |
---|---|---|
appId |
string |
Yalnızca pano bir uygulamaya aitse döndürülen uygulama kimliği |
displayName |
string |
Panonun görünen adı |
embedUrl |
string |
Panonun ekleme URL'si |
id |
string |
Pano kimliği |
isReadOnly |
boolean |
Panonun salt okunur olup olmadığı |
subscriptions |
(Boş Değer) Power BI öğesinin abonelik ayrıntıları (rapor veya pano gibi). Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Rapor Aboneliklerini Yönetici API çağrısı olarak al'ı kullanarak Power BI raporu için abonelik bilgilerini alabilirsiniz. |
|
tiles |
Panoya ait kutucuklar |
|
users |
(Boş değer) Pano kullanıcısı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Yönetici API çağrısı olarak Pano Kullanıcılarını Al çağrısını veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak bir Power BI panosundaki |
|
webUrl |
string |
Panonun web URL'si |
workspaceId |
string |
Panonun çalışma alanı kimliği (GUID). Bu özellik yalnızca GetDashboardsAsAdmin içinde döndürülür. |
AdminDashboards
Power BI pano koleksiyonu için OData yanıt sarmalayıcısı
Name | Tür | Description |
---|---|---|
odata.context |
string |
OData bağlamı |
value |
Pano koleksiyonu |
AdminTile
Yönetici API'leri tarafından döndürülen bir Power BI kutucuğu.
Name | Tür | Description |
---|---|---|
colSpan |
integer |
Kutucuk yayılma sütunlarının sayısı |
datasetId |
string |
Veri kümesi kimliği. Yalnızca bir rapordan veya Q&A kutucukları gibi bir veri kümesi kullanılarak oluşturulan kutucuklar için kullanılabilir. |
embedData |
string |
Kutucuk için ekleme verileri |
embedUrl |
string |
Kutucuğun ekleme URL'si |
id |
string |
Kutucuk kimliği |
reportId |
string |
Rapor kimliği. Yalnızca rapordan oluşturulan kutucuklar için kullanılabilir. |
rowSpan |
integer |
Kutucuk yayılma satırlarının sayısı |
title |
string |
Kutucuğun görünen adı |
DashboardUser
Power BI kullanıcısı bir pano için doğru erişime sahip giriş
Name | Tür | Description |
---|---|---|
dashboardUserAccessRight |
Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi) |
|
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ü. |
DashboardUserAccessRight
Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)
Name | Tür | Description |
---|---|---|
None |
string |
Panodaki içeriğe izin yok |
Owner |
string |
Rapordaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir |
Read |
string |
Panodaki içeriğe Okuma erişimi verir |
ReadCopy |
string |
Panodaki içeriğe Okuma ve Kopyalama erişimi verir |
ReadReshare |
string |
Panodaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir |
ReadWrite |
string |
Panodaki içeriğe Okuma ve Yazma erişimi verir |
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 |
Subscription
Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği
Name | Tür | Description |
---|---|---|
artifactDisplayName |
string |
Abone olunan Power BI öğesinin adı (rapor veya pano gibi) |
artifactId |
string |
Abone olunan Power BI öğesinin kimliği (rapor veya pano gibi) |
artifactType |
string |
Power BI öğesinin türü (örneğin |
attachmentFormat |
string |
E-posta aboneliğine eklenen raporun biçimi |
endDate |
string |
E-posta aboneliğinin bitiş tarihi ve saati |
frequency |
string |
E-posta aboneliğinin sıklığı |
id |
string |
Abonelik kimliği |
isEnabled |
boolean |
E-posta aboneliğinin etkinleştirilip etkinleştirilmediği |
linkToContent |
boolean |
E-posta aboneliğinde abonelik bağlantısı olup olmadığı |
previewImage |
boolean |
Raporun ekran görüntüsünün e-posta aboneliğinde olup olmadığı |
startDate |
string |
E-posta aboneliğinin başlangıç tarihi ve saati |
subArtifactDisplayName |
string |
Raporsa abone olunan Power BI öğesinin sayfa adı. |
title |
string |
Uygulama adı |
users |
Her e-posta abonesinin ayrıntıları. Kullanıcı Aboneliklerini API olarak Yönetici alma çağrısını kullanırken, döndürülen değer boş bir dizidir (null). Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Rapor Aboneliklerini Yönetici Olarak Al veya Pano Aboneliklerini YÖNETICI API çağrıları olarak al seçeneğini kullanarak bir Power BI raporu veya panosundaki abonelik bilgilerini alabilirsiniz. |
SubscriptionUser
Power BI e-posta aboneliği 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ü. |