Gateways - Create Datasource

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Belirtilen şirket içi ağ geçidinde yeni bir veri kaynağı oluşturur.

Şirket içi veri kaynağı kimlik bilgileri şifrelenmelidir. encryptedConnection parametresi olarak ayarlanmalıdır Encrypted ve kimlik bilgileri ağ geçidi ortak anahtarı kullanılarak şifrelenmelidir.

Bu API'yi kullanma örneği için Ağ Geçidi DataSource PowerShell betiği oluşturma bölümüne bakın. Bu betik, kimlik bilgilerini şifrelemek için aşağıdaki notta belirtilen PowerShell betiğini kullanır.

Uyarı

Kimlik bilgilerini şifrelemek için bkz. Power BI için kimlik bilgilerini program aracılığıyla yapılandırma ve EncryptCredentials .NET Core, Java, Python ve PowerShell örneklerini gözden geçirin.

Permissions

Yalnızca şirket içi ağ geçitlerini destekler ve kullanıcının ağ geçidi yönetici izinlerine sahip olması gerekir

Gerekli Kapsam

Veri Kümesi.OkumaYazma.Tümü

Sınırlamalar

Sanal ağ (VNet) ve Bulut ağ geçitleri desteklenmez.
Kimlik bilgisi türü olarak OAuth2 desteklenmez.

POST https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
gatewayId	path	True	string (uuid)	Ağ geçidi kimliği. Ağ geçidi kümesi kullanılırken, ağ geçidi kimliği kümedeki birincil (ilk) ağ geçidine başvurur. Bu gibi durumlarda ağ geçidi kimliği, ağ geçidi küme kimliğine benzer.

İstek Gövdesi

Name	Gerekli	Tür	Description
connectionDetails	True	string	Bağlantı ayrıntıları
credentialDetails	True	CredentialDetails	Kimlik bilgisi ayrıntıları
dataSourceName	True	string	Veri kaynağı adı
dataSourceType	True	string	Veri kaynağı türü

Yanıtlar

Name	Tür	Description
201 Created	GatewayDatasource	Oluşturuldu

Örnekler

Azure Analysis Services example

SQL example

Azure Analysis Services example

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources

İstek Gövdesi

{
  "dataSourceType": "AnalysisServices",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "datasourceName": "Sample Datasource",
  "credentialDetails": {
    "credentialType": "Windows",
    "credentials": "AB....EF==",
    "encryptedConnection": "Encrypted",
    "encryptionAlgorithm": "RSA-OAEP",
    "privacyLevel": "None"
  }
}

Örnek yanıt

Durum kodu:: 200

SQL example

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources

İstek Gövdesi

{
  "dataSourceType": "SQL",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "datasourceName": "Sample Datasource",
  "credentialDetails": {
    "credentialType": "Windows",
    "credentials": "AB....EF==",
    "encryptedConnection": "Encrypted",
    "encryptionAlgorithm": "RSA-OAEP",
    "privacyLevel": "None"
  }
}

Örnek yanıt

Durum kodu:: 200

Tanımlar

Name	Description
CredentialDetails	Kimlik bilgisi ayrıntıları
credentialType	Veri kaynağı kimlik bilgisi türü
encryptedConnection	Veri kaynağı bağlantısının şifrelenip şifrelmeyeceği. Şifrelemeyi seçerseniz VE Power BI veri kaynağıyla şifreli bir bağlantı kuramazsa API çağrısı başarısız olur.
encryptionAlgorithm	Şifreleme algoritması. Bulut veri kaynağı için belirtin `None`. Şirket içi veri kaynağı için kimlik bilgilerini şifrelemek için ağ geçidi ortak anahtarını belirtin `RSA-OAEP` ve kullanın.
GatewayDatasource	Power BI ağ geçidi veri kaynağı
GatewayDatasourceCredentialDetails	Veri kaynağı kimlik bilgisi ayrıntıları
privacyLevel	Birden çok kaynaktan gelen veriler birleştirildiğinde ilgili olan gizlilik düzeyi.
PublishDatasourceToGatewayRequest	Veri kaynağını ağ geçidi isteğine yayımlama

CredentialDetails

Object

Kimlik bilgisi ayrıntıları

Name	Tür	Description
credentialType	credentialType	Kimlik bilgisi türü
credentials	string	'credentialType' değerine bağlı olan kimlik bilgileri. Daha fazla bilgi için bkz . Veri Kaynağını Güncelleştirme örnekleri.
encryptedConnection	encryptedConnection	Veri kaynağı bağlantısının şifrelenip şifrelmeyeceği. Şifrelemeyi seçerseniz VE Power BI veri kaynağıyla şifreli bir bağlantı kuramazsa API çağrısı başarısız olur.
encryptionAlgorithm	encryptionAlgorithm	Şifreleme algoritması. Bulut veri kaynağı için belirtin `None`. Şirket içi veri kaynağı için kimlik bilgilerini şifrelemek için ağ geçidi ortak anahtarını belirtin `RSA-OAEP` ve kullanın.
privacyLevel	privacyLevel	Birden çok kaynaktan gelen veriler birleştirildiğinde ilgili olan gizlilik düzeyi.
useCallerAADIdentity	boolean	Veri kaynağı kimlik bilgilerini (sahip OAuth erişim belirteci) yapılandırmak için API çağıranın (veri kaynağı sahibi olması gerekir) Azure AD kimliğinin (OAuth 2.0 kimlik bilgileri) kullanılıp kullanılmayacağı. Genellikle bu bayrağı veya `useEndUserOAuth2Credentials`kullanırsınız.
useEndUserOAuth2Credentials	boolean	DirectQuery modunda veri kaynağına bağlanırken son kullanıcı Azure AD kimliğinin (OAuth 2.0 kimlik bilgileri) kullanılıp kullanılmadığı. Çoklu oturum açmayı (SSO) destekleyen veri kaynaklarıyla kullanın. Genellikle bu bayrağı veya `useCallerAADIdentity`kullanırsınız.

credentialType

Listeleme

Veri kaynağı kimlik bilgisi türü

Değer	Description
Basic
Windows
Anonymous
OAuth2
Key
SAS

encryptedConnection

Listeleme

Veri kaynağı bağlantısının şifrelenip şifrelmeyeceği. Şifrelemeyi seçerseniz VE Power BI veri kaynağıyla şifreli bir bağlantı kuramazsa API çağrısı başarısız olur.

Değer	Description
Encrypted
NotEncrypted

encryptionAlgorithm

Listeleme

Şifreleme algoritması. Bulut veri kaynağı için belirtin None. Şirket içi veri kaynağı için kimlik bilgilerini şifrelemek için ağ geçidi ortak anahtarını belirtin RSA-OAEP ve kullanın.

Değer	Description
None
RSA-OAEP

GatewayDatasource

Object

Power BI ağ geçidi veri kaynağı

Name

Tür

Description

connectionDetails

string

JSON biçiminde bağlantı ayrıntıları

credentialDetails

GatewayDatasourceCredentialDetails

Güncelleştirilmesi gereken veri kaynağının bağlantı ayrıntıları. Veri kümesinde birden fazla veri kaynağı olduğunda bağlantı ayrıntıları zorunlu olur.

credentialType

Veri kaynağı kimlik bilgisi türü

datasourceName

string

Veri kaynağının adı

datasourceType

string

Veri kaynağının türü.

Veri kaynağı için API adı
ActiveDirectory	AdobeAnalytics	AdoDotNet
AnalysisServices	AzureBlobs	AzureDataLakeStorage
AzureMarketplace	AzureTable'lar	BizTalk
CDPA	CustomConnector	ÖzelHttpApi
DB2	Essbase	EventHub
Excel	Değiş Tokuş	Extension
Facebook	Dosya	Klasör
GoogleAnalytics	Hdfs	HDInsight
Informix	MQ	MySql
OData	ODBC	OleDb
Oracle	PostgreSql	PowerQueryMashup
PubNub	Salesforce	SAPBW
SAPBWMessageServer	SapErp	SAPHana
SharePoint	SharePointDocLib	SharePointList
SQL	Sybase	Teradata
UIFlow	İnternet

gatewayId

string (uuid)

İlişkili ağ geçidi kimliği. Ağ geçidi kümesi kullanılırken, ağ geçidi kimliği kümedeki birincil (ilk) ağ geçidine başvurur ve ağ geçidi küme kimliğine benzer.

string (uuid)

Veri kaynağının benzersiz kimliği

GatewayDatasourceCredentialDetails

Object

Veri kaynağı kimlik bilgisi ayrıntıları

Name	Tür	Description
useEndUserOAuth2Credentials	boolean	DirectQuery modunda veri kaynağına bağlanırken son kullanıcı Azure AD kimliğinin (OAuth 2.0 kimlik bilgileri) kullanılıp kullanılmadığı. Çoklu oturum açmayı (SSO) destekleyen veri kaynaklarıyla kullanın.

privacyLevel

Listeleme

Birden çok kaynaktan gelen veriler birleştirildiğinde ilgili olan gizlilik düzeyi.

Değer	Description
None
Public
Organizational
Private

PublishDatasourceToGatewayRequest

Object

Veri kaynağını ağ geçidi isteğine yayımlama

Name	Tür	Description
connectionDetails	string	Bağlantı ayrıntıları
credentialDetails	CredentialDetails	Kimlik bilgisi ayrıntıları
dataSourceName	string	Veri kaynağı adı
dataSourceType	string	Veri kaynağı türü

Aracılığıyla paylaş

Gateways - Create Datasource

Permissions

Gerekli Kapsam

Sınırlamalar

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Azure Analysis Services example

Örnek isteği

Örnek yanıt

SQL example

Örnek isteği

Örnek yanıt

Tanımlar

CredentialDetails

credentialType

encryptedConnection

encryptionAlgorithm

GatewayDatasource

GatewayDatasourceCredentialDetails

privacyLevel

PublishDatasourceToGatewayRequest