Admin - Imports GetImportsAsAdmin

  • Başvuru
Service:
Power BI REST APIs
API Version:
v1.0

Kuruluş için içeri aktarmaları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

Saatte en fazla 200 istek. 

GET https://api.powerbi.com/v1.0/myorg/admin/imports
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/imports?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

URI Parametreleri

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

string

İlgili varlıkları satır içi genişletir
$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

Imports

Tamam

Örnekler

Example

Sample Request

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

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "importState": "Succeeded",
      "createdDateTime": "2018-05-08T14:56:18.477Z",
      "updatedDateTime": "2018-05-08T14:56:18.477Z",
      "name": "SalesMarketing",
      "connectionType": "import",
      "source": "Upload",
      "datasets": [
        {
          "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "name": "SalesMarketing",
          "webUrl": "https://app.powerbi.com/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229"
        }
      ],
      "reports": [
        {
          "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"
        }
      ]
    }
  ]
}

Tanımlar

Name Description
Dataset

Power BI veri kümesi. API, aşağıdaki veri kümesi ö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.
DatasetQueryScaleOutSettings

Veri kümesinin ölçeği genişletme ayarlarını sorgulama
DatasetUser

Power BI kullanıcısı bir veri kümesi için doğru erişime sahip giriş
DatasetUserAccessRight

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

Power BI'a bağımlı veri akışı
Encryption

Veri kümesi için şifreleme bilgileri
EncryptionStatus

Veri kümesi şifreleme durumu
Import

İçeri aktarma nesnesi
Imports

Power BI içeri aktarma koleksiyonu için OData yanıt sarmalayıcısı
PrincipalType

Sorumlu türü
Report

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

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ı

Dataset

Power BI veri kümesi. API, aşağıdaki veri kümesi ö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
ContentProviderType

string

Veri kümesinin içerik sağlayıcısı türü
CreateReportEmbedURL

string

Veri kümesi rapor ekleme URL'si oluşturur
CreatedDate

string

Veri kümesi oluşturma tarihi ve saati
Encryption

Encryption

Veri kümesi şifreleme bilgileri. Yalnızca belirtildiğinde $expand geçerlidir.
IsEffectiveIdentityRequired

boolean

Veri kümesinin etkin bir kimlik gerektirilip gerekmediği; bunu bir GenerateToken API çağrısında göndermeniz gerekir.
IsEffectiveIdentityRolesRequired

boolean

Satır düzeyi güvenliğin Power BI .pbix dosyasında tanımlanıp tanımlanmadığı. Öyleyse, bir rol belirtmeniz gerekir.
IsInPlaceSharingEnabled

boolean

Veri kümesinin kendi kiracılarında kullanılacak dış kullanıcılarla paylaşılıp paylaşılamayacağı
IsOnPremGatewayRequired

boolean

Veri kümesinin şirket içi veri ağ geçidi gerekip gerekmediği
IsRefreshable

boolean

Veri kümesinin yenilenebilir olup olmadığı. Power BI yenilenebilir veri kümesi, en az bir kez yenilenen veya geçerli bir yenileme zamanlaması bulunan bir veri kümesidir.
QnaEmbedURL

string

Q&A ekleme URL'si veri kümesi
addRowsAPIEnabled

boolean

Veri kümesinin yeni satır eklemeye izin verip vermediği
configuredBy

string

Veri kümesi sahibi
description

string

Veri kümesi açıklaması
id

string

Veri kümesi kimliği
name

string

Veri kümesi adı
queryScaleOutSettings

DatasetQueryScaleOutSettings

Veri kümesinin ölçeği genişletme ayarlarını sorgulama
targetStorageMode

string

Veri kümesi depolama modu
upstreamDataflows

DependentDataflow[]

Bu öğenin bağlı olduğu tüm veri akışlarının listesi
users

DatasetUser[]

(Boş değer) Veri kümesi kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Veri Kümesi Kullanıcılarını Yönetici API'sini veya postWorkspaceInfo API'sini parametresiyle getArtifactUsers kullanarak bir Power BI öğesindeki (rapor veya pano gibi) kullanıcı bilgilerini alabilirsiniz.
webUrl

string

Veri kümesinin web URL'si

DatasetQueryScaleOutSettings

Veri kümesinin ölçeği genişletme ayarlarını sorgulama

Name Tür Description
autoSyncReadOnlyReplicas

boolean

Veri kümesinin salt okunur çoğaltmaları otomatik olarak eşitleyip eşitlemediği
maxReadOnlyReplicas

integer

Veri kümesi için en fazla salt okunur çoğaltma sayısı (otomatik çoğaltma sayısı için 0-64, -1)

DatasetUser

Power BI kullanıcısı bir veri kümesi için doğru erişime sahip giriş

Name Tür Description
datasetUserAccessRight

DatasetUserAccessRight

Kullanıcının veri kümesi 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

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

DatasetUserAccessRight

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

Name Tür Description
None

string

Veri kümesindeki içeriğe yönelik izni kaldırır
Read

string

Veri kümesindeki içeriğe Okuma erişimi verir
ReadExplore

string

Veri kümesindeki içeriğe Okuma ve Araştırma erişimi verir
ReadReshare

string

Veri kümesindeki içeriğe Okuma ve Yeniden Paylaşma erişimi verir
ReadReshareExplore

string

Veri kümesindeki içeriğe Okuma, Yeniden Paylaşma ve Araştırma erişimi verir
ReadWrite

string

Veri kümesindeki içeriğe Okuma ve Yazma erişimi verir
ReadWriteExplore

string

Veri kümesindeki içeriğe Okuma, Yazma ve Araştırma erişimi verir
ReadWriteReshare

string

Veri kümesindeki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir
ReadWriteReshareExplore

string

Veri kümesindeki içeriğe Okuma, Yazma, Yeniden Paylaşma ve Araştırma erişimi verir

DependentDataflow

Power BI'a bağımlı veri akışı

Name Tür Description
groupId

string

Hedef grup kimliği
targetDataflowId

string

Hedef veri akışı kimliği

Encryption

Veri kümesi için şifreleme bilgileri

Name Tür Description
EncryptionStatus

EncryptionStatus

Veri kümesi şifreleme durumu

EncryptionStatus

Veri kümesi şifreleme durumu

Name Tür Description
InSyncWithWorkspace

string

Şifreleme desteklenir ve şifreleme ayarlarıyla eşitlenir
NotInSyncWithWorkspace

string

Şifreleme desteklenir ancak şifreleme ayarlarıyla eşitlenmez
NotSupported

string

Bu veri kümesi için şifreleme desteklenmiyor
Unknown

string

Veri kümesi bozulması nedeniyle şifreleme durumu bilinmiyor

Import

İçeri aktarma nesnesi

Name Tür Description
createdDateTime

string

İçeri aktarma oluşturma tarihi ve saati
datasets

Dataset[]

Bu içeri aktarma ile ilişkili veri kümeleri
id

string

İçeri aktarma kimliği
importState enum:
  • Failed
  • Publishing
  • Succeeded

İçeri aktarma karşıya yükleme durumu
name

string

İçeri aktarma adı
reports

Report[]

Bu içeri aktarmayla ilişkili raporlar
updatedDateTime

string

Son güncelleştirme tarihini ve saatini içeri aktarma

Imports

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

Name Tür Description
odata.context

string

OData bağlamı
value

Import[]

İçeri aktarma 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ü

Report

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
datasetId

string

Raporun veri kümesi kimliği
description

string

Rapor açıklaması
embedUrl

string

Raporun ekleme URL'si
id

string

Rapor kimliği
name

string

Raporun adı
originalReportId

string

Çalışma alanı uygulama olarak yayımlandığında gerçek rapor kimliği.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Rapor türü
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.
users

ReportUser[]

(Boş değer) Power BI raporunun 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 çağrısı olarak al veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak bir Power BI raporundaki getArtifactUsers kullanıcı bilgilerini alabilirsiniz.
webUrl

string

Raporun web URL'si

ReportUser

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

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

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