Admin - Imports GetImportsAsAdmin

Hizmet:
Power BI REST APIs
API Sürümü:
v1.0

Kuruluş için içeri aktarmaların listesini döndürür.

İzinler

  • Kullanıcının Doku yöneticisi 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 uygulama Azure portalında Power BI için yönetici onayı gerekli izinlerin ayarlanmaması.

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
İsteğe bağlı parametrelerle: 
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

İlişkili varlıkları satır içi olarak genişletir
$filter
 query

string

Odata filtre sorgusu parametre koşuluna göre sonuçların bir alt kümesini döndürür.
$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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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ı veri kümesi için doğru erişim girdisi
DatasetUserAccessRight

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

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

Veri kümesi için şifreleme bilgileri
EncryptionStatus

Veri kümesi şifreleme durumu
Import

İçeri aktarma nesnesi
ImportError

Başarısız içeri aktarma için hata ayrıntıları
Imports

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

Power BI hata yanıtı hakkında ayrıntılı bilgi
PrincipalType

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

Power BI kullanıcısı bir rapor için doğru girişe erişti
ReportUserAccessRight

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

Power BI hizmet sorumlusu 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ı

Dataset

Nesne

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

Anlam modeli için içerik sağlayıcısı türü.

Aşağıdaki ContentProviderTypes kiracı giriş bölgesinde depolanır:

ContentProviderType
Excel
CSV
UsageMetricsUserReport
UsageMetricsUserDashboard
RealTimeInPushMode
RealTimeInPubNubMode
RealTimeInStreamingMode

Aşağıdaki ContentProviderTypes, Kapasite bölgesinde depolanır:

ContentProviderType
PowerBIDesktop
PowerBIModelingService
PbixInImportMode
PbixInDirectQueryMode
PbixInCompositeMode
InImportMode
InDirectQueryMode
InCompositeMode
Encryption

Encryption

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

boolean

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

string

Veri kümesi sahibi
createReportEmbedURL

string

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

string (date-time)

Veri kümesi oluşturma tarihi ve saati
description

string

Veri kümesi açıklaması
id

string

Veri kümesi kimliği
isEffectiveIdentityRequired

boolean

Veri kümesinin etkili bir kimlik gerekip gerekmediği; 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 tüketilecek dış kullanıcılarla paylaşılıp paylaşılamayacağı
isOnPremGatewayRequired

boolean

Veri kümesinin şirket içi veri ağ geçidi gerekip gerektirmediği
isRefreshable

boolean

Bu alan, veri kümesi yakın zamanda yenilendiğinde veya bağlantı modu özel olarak 'İçeri Aktar' olarak ayarlandığında otomatik yenileme için yapılandırıldığında true döndürür. Değer, veri kümesinin el ile yenilenmesinden veya otomatik yenileme için ayarlanmasından bağımsız olarak 'DirectQuery' ve 'LiveConnection' gibi diğer bağlantı modları için false döndürür.
name

string

Veri kümesi adı
qnaEmbedURL

string

Q&A ekleme URL'si veri kümesi
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 Olarak Al kullanarak bir Power BI öğesinde (rapor veya pano gibi) kullanıcı bilgilerini alabilirsiniz.
webUrl

string

Veri kümesinin web URL'si

DatasetQueryScaleOutSettings

Nesne

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

minimum: -1
maximum: 64

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

DatasetUser

Nesne

Power BI kullanıcısı veri kümesi için doğru erişim girdisi

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

Asıl tür
profile

ServicePrincipalProfile

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

string

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

DatasetUserAccessRight

Numaralandırma

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

Değer Description
None

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

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

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

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

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

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

Veri kümesindeki içeriğe Okuma, Yeniden Paylaşma ve Keşfetme erişimi verir
ReadWriteExplore

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

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

DependentDataflow

Nesne

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

Name Tür Description
groupId

string

Hedef grup kimliği
targetDataflowId

string

Hedef veri akışı kimliği

Encryption

Nesne

Veri kümesi için şifreleme bilgileri

Name Tür Description
EncryptionStatus

EncryptionStatus

Veri kümesi şifreleme durumu

EncryptionStatus

Numaralandırma

Veri kümesi şifreleme durumu

Değer Description
Unknown

Veri kümesi bozulması nedeniyle şifreleme durumu bilinmiyor
NotSupported

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

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

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

Import

Nesne

İçeri aktarma nesnesi

Name Tür Description
createdDateTime

string (date-time)

Oluşturma tarih ve saatini içeri aktarma
datasets

Dataset[]

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

ImportError

İçeri aktarma başarısız olduğunda hata ayrıntıları
id

string (uuid)

İç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 (date-time)

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

ImportError

Nesne

Başarısız içeri aktarma için hata ayrıntıları

Name Tür Description
code

string

Hata kodu
details

PowerBIApiErrorResponseDetail[]

Hata ayrıntıları dizisi

Imports

Nesne

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

PowerBIApiErrorResponseDetail

Nesne

Power BI hata yanıtı hakkında ayrıntılı bilgi

Name Tür Description
code

string

Hata kodu
message

string

Hata iletisi
target

string

Hata hedefi

PrincipalType

Numaralandırma

Asıl tür

Değer Description
None

Sorumlu türü yok. Kuruluş düzeyinde erişimin tamamı için kullanın.
User

Kullanıcı asıl türü
Group

Grup sorumlusu türü
App

Hizmet sorumlusu türü

Report

Nesne

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
format

string

Rapor tanımı biçim türü. PowerBIReport için:

PaginatedReport için:
id

string (uuid)

Rapor kimliği
isOwnedByMe

boolean

Geçerli kullanıcının raporu değiştirme veya raporun bir kopyasını oluşturma yeteneği olup olmadığını gösterir.
name

string

Raporun adı. Uygulama raporları [App] ön eki ile başlar.
originalReportId

string (uuid)

Ç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. Rapor Aboneliklerini Yönetici API çağrısı olarak alma kullanarak Power BI raporu için 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 olarak Al API çağrısını veya parametresiyle PostWorkspaceInfo getArtifactUsers kullanarak Power BI raporundaki kullanıcı bilgilerini alabilirsiniz.
webUrl

string

Raporun web URL'si

ReportUser

Nesne

Power BI kullanıcısı bir rapor için doğru girişe erişti

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 hizmet sorumlusu 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

Numaralandırma

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

Değer Description
None

Raporda içerik için izin yok
Read

Rapordaki içeriğe Okuma erişimi verir
ReadWrite

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

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

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

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

ServicePrincipalProfile

Nesne

Power BI hizmet sorumlusu 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 (uuid)

Hizmet sorumlusu profil kimliği

Subscription

Nesne

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 (uuid)

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 (date-time)

E-posta aboneliğinin bitiş tarihi ve saati
frequency

string

E-posta aboneliğinin sıklığı
id

string (uuid)

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 mevcut olup olmadığı
startDate

string (date-time)

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 Yönetici Olarak Al API çağrısı 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. Rapor Aboneliklerini Yönetici Olarak Al kullanarak veya Pano Aboneliklerini Yönetici Olarak Al API çağrılarını bir Power BI raporu veya panosundaki abonelik bilgilerini alabilirsiniz.

SubscriptionUser

Nesne

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 hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.
userType

string

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