Aracılığıyla paylaş


Admin - Reports GetReportsAsAdmin

Kuruluş için raporları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 prinicipal 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/reports
GET https://api.powerbi.com/v1.0/myorg/admin/reports?$filter={$filter}&$top={$top}&$skip={$skip}

URI Parametreleri

Name İçinde Gerekli Tür Description
$filter
query

string

Sonuçları boole koşuluna göre 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

AdminReports

Tamam

Örnekler

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/reports

Sample Response

{
  "value": [
    {
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com//reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715",
      "workspaceId": "278e22a3-2aee-4057-886d-c3225423bc10"
    }
  ]
}

Tanımlar

Name Description
AdminReport

Yönetici API'leri tarafından döndürülen bir Power BI raporu. API, aşağıdaki rapor ö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.

AdminReports

Power BI Yönetici rapor koleksiyonu için OData yanıt sarmalayıcısı

PrincipalType

Sorumlu türü

ReportUser

Bir rapor için Power BI kullanıcı erişim hakkı girdisi

ReportUserAccessRight

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

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çö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ı

AdminReport

Yönetici API'leri tarafından döndürülen bir Power BI raporu. API, aşağıdaki rapor ö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 rapor bir uygulamaya aitse döndürülen uygulama kimliği

createdBy

string

Rapor sahibi. Yalnızca Haziran 2019'dan sonra oluşturulan raporlarda kullanılabilir.

createdDateTime

string

Rapor oluşturma tarihi ve saati

datasetId

string

Raporun veri kümesi kimliği

description

string

Rapor açıklaması

embedUrl

string

Raporun ekleme URL'si

id

string

Rapor kimliği

isOwnedByMe

boolean

Raporun geçerli kullanıcı tarafından oluşturulup oluşturulmadığını belirleyin.

modifiedBy

string

Raporu değiştiren son kullanıcı

modifiedDateTime

string

Raporun son değiştirildiği tarih ve saat

name

string

Raporun adı

originalReportId

string

Çalışma alanı bir uygulama olarak yayımlandığında gerçek rapor kimliği.

reportType enum:
  • PaginatedReport
  • PowerBIReport

Rapor türü

subscriptions

Subscription[]

(Boş Değer) Bir Power BI öğesinin (rapor veya pano gibi) abonelik 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 Rapor Aboneliklerini Al'ı kullanarak bir Power BI raporunun abonelik bilgilerini alabilirsiniz.

users

ReportUser[]

(Boş değer) Power BI raporu için kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Rapor Kullanıcılarını Yönetici API olarak alma çağrısını veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak bir Power BI raporundaki getArtifactUsers kullanıcı bilgilerini alabilirsiniz.

webUrl

string

Raporun web URL'si

workspaceId

string

Raporun çalışma alanı kimliği (GUID). Bu özellik yalnızca GetReportsAsAdmin içinde döndürülür.

AdminReports

Power BI Yönetici rapor koleksiyonu için OData yanıt sarmalayıcısı

Name Tür Description
odata.context

string

OData bağlamı

value

AdminReport[]

Rapor koleksiyonu

PrincipalType

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

ReportUser

Bir rapor için Power BI kullanıcı erişim hakkı girdisi

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

Sorumlu türü

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

reportUserAccessRight

ReportUserAccessRight

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

userType

string

Kullanıcının türü.

ReportUserAccessRight

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

Name Tür Description
None

string

Rapordaki içeriğe izin yok

Owner

string

Rapordaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir

Read

string

Rapordaki içeriğe Okuma erişimi verir

ReadCopy

string

Rapordaki içeriğe Okuma ve Kopyalama erişimi verir

ReadReshare

string

Rapordaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir

ReadWrite

string

Rapordaki içeriğe Okuma ve Yazma erişimi verir

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çö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, , Dashboardveya 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

Bir raporsa abone olunan Power BI öğesinin sayfa adı.

title

string

Uygulama adı

users

SubscriptionUser[]

Her e-posta abonesinin ayrıntıları. Api çağrısını Yönetici Olarak Kullanıcı Aboneliklerini Al kullanıldığında, 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. Bir Power BI raporu veya panosundaki abonelik bilgilerini almak için Rapor Aboneliklerini Yönetici Olarak Al veya Pano Aboneliklerini Yönetici API çağrıları olarak al'ı kullanabilirsiniz.

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

Sorumlu türü

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

userType

string

Kullanıcının türü.