Datasets - Get Datasets

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

çalışma alanım veri kümelerinin listesini döndürür.

Gerekli Kapsam

Dataset.ReadWrite.All veya Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets

Yanıtlar

Name	Tür	Description
200 OK	Datasets	Tamam

Örnekler

Example

Örnek isteği

GET https://api.powerbi.com/v1.0/myorg/datasets

Örnek yanıt

Durum kodu:

200

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false
    }
  ]
}

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
Datasets	Veri kümesi OData liste sarmalayıcısı
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
PrincipalType	Asıl tür
ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.

Dataset

Object

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	Yoksayılması gereken kullanım dışı bir özellik.
Encryption	Encryption	Veri kümesi şifreleme bilgileri. Yalnızca $expand belirtildiğinde geçerlidir.
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.
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
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

Object

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)

Datasets

Object

Veri kümesi OData liste sarmalayıcısı

Name	Tür	Description
@odata.context	string	OData bağlamı
value	Dataset[]	Veri kümeleri

DatasetUser

Object

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

Listeleme

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

Object

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

Name	Tür	Description
groupId	string	Hedef grup kimliği
targetDataflowId	string	Hedef veri akışı kimliği

Encryption

Object

Veri kümesi için şifreleme bilgileri

Name	Tür	Description
EncryptionStatus	EncryptionStatus	Veri kümesi şifreleme durumu

EncryptionStatus

Listeleme

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

PrincipalType

Listeleme

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ü

ServicePrincipalProfile

Object

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