Imports - Post Import

Service:

Power BI REST APIs

API Version:

v1.0

Çalışma alanım'da yeni içerik oluşturur.

Bu API'yi kullanma örneği için büyük dosyaları içeri aktarma PowerShell betiğine bakın.

Not

Desteklenen içerik:

• Power BI .pbix dosyaları
• JSON dosyaları (.json)
• Excel dosyaları (.xlsx)
• RDL dosyaları (.rdl)

• Bir dosyayı içeri aktarmak için, istek üst bilgilerinde çok parçalı/form-veri içerik türünü belirtin ve dosyayı istek gövdesinde form verileri olarak kodlar.
• Bir .rdl dosyasını içeri aktarmak için, URI parametrelerinde açıklandığı gibi tarafından datasetDisplayNamebelirtilen ada dosya uzantısını ekleyin.
• OneDrive İş'dan bir .xlsx dosyasını içeri aktarmak için istek üst bilgilerine application/json içerik türünü ekleyin. İstek gövdesindeki .xlsx dosya yoluna ayarlanmış ImportInfofilePath ekleyin.
• Boyutu 1 GB ile 10 GB arasında olan büyük Power BI .pbix dosyalarını içeri aktarmak için bkz. Geçici Karşıya Yükleme Konumu İçerik Oluşturucu. Bu yalnızca Premium kapasite çalışma alanları için desteklenir.
• model.json dosyasından veri akışı oluşturmak için URI parametrelerinde açıklandığı gibi model.json olarak ayarlayındatasetDisplayName.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

• Hizmet sorumlusuna sahip veri akışları desteklenmez.
• Power BI .pbix dosyasını OneDrive'dan içeri aktarma desteklenmez.
• Korumalı duyarlılık etiketine sahip bir dosyanın içeri aktarılması hizmet sorumluları için desteklenmez.
  
  

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName={datasetDisplayName}

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}&subfolderObjectId={subfolderObjectId}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetDisplayName	query	True	string	Veri kümesinin görünen adı dosya uzantısını içermelidir. OneDrive İş'dan içeri aktarılırken desteklenmez.
nameConflict	query		ImportConflictHandlerMode	Aynı ada sahip bir veri kümesi zaten varsa ne yapacağını belirtir. Ignore varsayılan değerdir. RDL dosyaları Abort için ve Overwrite desteklenen tek seçeneklerdir.
overrideModelLabel	query		boolean	Power BI .pbix dosyasını yeniden yayımlarken modelde var olan etiketin geçersiz kılınıp kılınmayacağı. Hizmet varsayılan değeri şeklindedir true.
overrideReportLabel	query		boolean	Power BI .pbix dosyası yeniden yayımlandığında mevcut rapor etiketinin geçersiz kılınıp kılınmayacağı. Hizmet varsayılan değeri şeklindedir true.
skipReport	query		boolean	Rapor içeri aktarmanın atlanıp atlanmayacağı. Belirtilirse, değeri olmalıdır true. Yalnızca Power BI .pbix dosyaları için desteklenir.
subfolderObjectId	query		string uuid	Dosyayı alt klasöre aktarmak için alt klasör kimliği.

İstek Gövdesi

Media Types: "application/json", "multipart/form-data"

Name	Tür	Description
connectionType	connectionType	OneDrive İş dosyasının içeri aktarma bağlantı türü
filePath	string	İçeri aktarılacak OneDrive İş Excel (.xlsx) dosyasının yolu; mutlak veya göreli olabilir. Power BI .pbix dosyaları desteklenmez.
fileUrl	string	Boyutu 1 GB ile 10 GB arasında olan büyük Power BI .pbix dosyalarını içeri aktarmak için kullanılan geçici blob depolama alanının paylaşılan erişim imzası URL'si.

Yanıtlar

Name	Tür	Description
200 OK	Import	Tamam
202 Accepted	Import	Kabul edildi

Örnekler

Import dataflow example

Post import example

Post import with 'skipReport' example

Import dataflow example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=model.json&nameConflict=Abort

Request Body

{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data name=model.json; filename=model.json Content-Type: application/json [Contents of Model JSON Encoded] --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

Status code:

202

{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=MyReport&nameConflict=Ignore

Request Body

{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

Status code:

202

{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import with 'skipReport' example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=MyReport&nameConflict=Ignore&skipReport=True&overrideReportLabel=True&overrideModelLabel=True

Request Body

{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

Status code:

202

{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Tanımlar

Name	Description
connectionType	OneDrive İş dosyasının içeri aktarma bağlantı türü
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
ImportConflictHandlerMode	Aynı ada sahip bir veri kümesi zaten varsa ne yapacağını belirtir. Ignore varsayılan değerdir. RDL dosyaları Abort için ve Overwrite desteklenen tek seçeneklerdir.
ImportInfo	İçeri aktarma ile ilgili bilgiler
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	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 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ı

connectionType

OneDrive İş dosyasının içeri aktarma bağlantı türü

Name	Tür	Description
connect	string
import	string

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

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 Keşfetme 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 Keşfetme 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

ImportConflictHandlerMode

Aynı ada sahip bir veri kümesi zaten varsa ne yapacağını belirtir. Ignore varsayılan değerdir. RDL dosyaları Abort için ve Overwrite desteklenen tek seçeneklerdir.

Name	Tür	Description
Abort	string	Aynı ada sahip bir veri kümesi zaten varsa, içeri aktarma işlemi iptal edilir.
CreateOrOverwrite	string	Aynı ada sahip bir veri kümesi zaten varsa, içeri aktarma işlemi mevcut veri kümesini yenisiyle değiştirir. Aynı ada sahip birden fazla veri kümesi varsa içeri aktarma işlemi başarısız olur.
GenerateUniqueName	string	Aynı ada sahip bir veri akışı zaten varsa, içeri aktarma işlemi yeni veri akışı için yeni bir benzersiz ad oluşturur.
Ignore	string	Aynı ada sahip bir veri kümesi zaten varsa, içeri aktarma işlemi aynı ada sahip yeni bir veri kümesi oluşturur.
Overwrite	string	Aynı ada sahip bir veri kümesi zaten varsa, içeri aktarma işlemi mevcut veri kümesini yenisiyle değiştirir. Çakışma yoksa veya aynı ada sahip birden fazla veri kümesi varsa içeri aktarma işlemi başarısız olur.

ImportInfo

İçeri aktarma ile ilgili bilgiler

Name	Tür	Description
connectionType	connectionType	OneDrive İş dosyasının içeri aktarma bağlantı türü
filePath	string	İçeri aktarılacak OneDrive İş Excel (.xlsx) dosyasının yolu; mutlak veya göreli olabilir. Power BI .pbix dosyaları desteklenmez.
fileUrl	string	Boyutu 1 GB ile 10 GB arasında olan büyük Power BI .pbix dosyalarını içeri aktarmak için kullanılan geçici blob depolama alanının paylaşılan erişim imzası URL'si.

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ü

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
isOwnedByMe	boolean	Raporun geçerli kullanıcı tarafından oluşturulup oluşturulmadığını belirleyin.
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çerik için 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 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ü.