Admin - Imports GetImportsAsAdmin

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 özel 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 olarak genişletir
$filter	query		string	Boole koşuluna göre sonuçları 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	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ı

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

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

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