Aracılığıyla paylaş


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 tiles.

$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

AdminDashboards

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
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.

AdminDashboards

Power BI pano koleksiyonu için OData yanıt sarmalayıcısı

AdminTile

Yönetici API'leri tarafından döndürülen bir Power BI kutucuğu.

DashboardUser

Power BI kullanıcısı bir pano için doğru erişime sahip giriş

DashboardUserAccessRight

Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)

PrincipalType

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.

Subscription

Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği

SubscriptionUser

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

Subscription[]

(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

AdminTile[]

Panoya ait kutucuklar

users

DashboardUser[]

(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 getArtifactUsers kullanıcı bilgilerini alabilirsiniz.

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

AdminDashboard[]

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

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

PrincipalType

Asıl tür

profile

ServicePrincipalProfile

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 Report, Dashboard, veya Dataset)

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

SubscriptionUser[]

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

PrincipalType

Asıl tür

profile

ServicePrincipalProfile

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ü.