Admin - Datasets GetDatasetsInGroupAsAdmin

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

Belirtilen çalışma alanındaki veri kümelerinin 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 prinicipal 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/groups/{groupId}/datasets

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets?$filter={$filter}&$top={$top}&$skip={$skip}&$expand={$expand}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
groupId	path	True	string uuid	Çalışma alanı kimliği
$expand	query		string	İlgili varlıkları satır içi genişletir
$filter	query		string	Sonuçları boole koşuluna göre 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	AdminDatasets	Tamam

Örnekler

Example

Example with expand on encryption

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets

Sample Response

Status code:: 200

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

Example with expand on encryption

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets?$expand=encryption

Sample Response

Status code:: 200

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

Tanımlar

Name	Description
AdminDataset	Yönetici API'leri tarafından döndürülen bir 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.
AdminDatasets	Veri kümesi odata listesi sarmalayıcısı
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
PrincipalType	Sorumlu türü
ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

AdminDataset

Yönetici API'leri tarafından döndürülen bir 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
workspaceId	string	Veri kümesi çalışma alanı kimliği. Bu özellik yalnızca GetDatasetsAsAdmin içinde döndürülür.

AdminDatasets

Veri kümesi odata listesi sarmalayıcısı

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

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

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ü

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

Admin - Datasets GetDatasetsInGroupAsAdmin

İzinler

Gerekli Kapsam

Sınırlamalar

URI Parametreleri

Yanıtlar

Örnekler

Example

Sample Request

Sample Response

Example with expand on encryption

Sample Request

Sample Response

Tanımlar

AdminDataset

AdminDatasets

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

PrincipalType

ServicePrincipalProfile

Ek kaynaklar