Aracılığıyla paylaş


Imports - Post Import In Group

Belirtilen çalışma alanında yeni içerik oluşturur.

Not

Desteklenen içerik:

  • Power BI .pbix dosyaları
  • JSON dosyaları (.json)
  • Excel dosyaları (.xlsx)
  • Rapor Tanımı Dil dosyalarını (.rdl) SQL Server
  • 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, dosya uzantısını URI parametrelerinde açıklandığı gibi tarafından datasetDisplayNamebelirtilen ada 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. İçerik Oluşturucu Group'ta Geçici Karşıya Yükleme Konumu ve Büyük Dosyaları İçeri Aktar PowerShell betiği. 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.

İzinler

Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

  • Hizmet sorumlusu olan 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/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}&subfolderObjectId={subfolderObjectId}

URI Parametreleri

Name İçinde Gerekli Tür Description
groupId
path True

string

uuid

Çalışma alanı kimliği

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. Veri akışlarını içeri aktarmak veya oluşturmak için bu parametre model.json olarak sabit kodlanmalıdır.

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. Veri akışı model.json dosyaları Abort için ve GenerateUniqueName desteklenen tek seçeneklerdir.

overrideModelLabel
query

boolean

Power BI .pbix dosyasını yeniden yayımlarken modeldeki mevcut etiketi geçersiz kılıp geçersiz kılmayacağını belirler. Hizmet varsayılan değeri şeklindedir true.

overrideReportLabel
query

boolean

Power BI .pbix dosyası yeniden yayımlandığında rapordaki mevcut etiketin 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 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 model.json example
Post import example
Post import skip report example

Import dataflow model.json example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=model.json&nameConflict=Abort&skipReport=True
{
  "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

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

Post import example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

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

Post import skip report example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore&skipReport=True&overrideReportLabel=True&overrideModelLabel=True
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

{
  "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

Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi

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. Veri akışı model.json dosyaları Abort için ve GenerateUniqueName desteklenen tek seçeneklerdir.

ImportInfo

İçeri aktarmayla ilgili bilgiler

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

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ı

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 etkili bir kimlik gerektirilip gerekmediği; 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 gerektip gerektirmediğ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 olarak alma veya PostWorkspaceInfo API'sini parametresiyle getArtifactUsers kullanarak bir Power BI öğesindeki kullanıcı bilgilerini (rapor veya pano gibi) 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

Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi

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

Oluşturma tarih ve saatini içeri aktarma

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 tarih 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. Veri akışı model.json dosyaları Abort için ve GenerateUniqueName desteklenen tek seçeneklerdir.

Name Tür Description
Abort

string

Aynı ada sahip veri kümesi veya veri akışı 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 aktarmayla 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 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

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

isOwnedByMe

boolean

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

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

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