Gateways - Create Datasource

Başvuru

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 Bkz. Ağ Geçidi Veri Kaynağı PowerShell betiği oluşturma. Bu betik, kimlik bilgilerini şifrelemek için aşağıdaki notta belirtilen PowerShell betiğini kullanır.

Not

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.

İzinler

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

Dataset.ReadWrite.All

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. Böyle 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şturulan

Ö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 bilgilerinin 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	Ağ geçidi isteğine veri kaynağı 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ının 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

Enumeration

Veri kaynağı kimlik bilgilerinin türü

Değer	Description
Anonymous
Basic
Key
OAuth2
SAS
Windows

encryptedConnection

Enumeration

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

Enumeration

Ş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 bilgilerinin 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	AzureTables	BizTalk
CDPA	CustomConnector	ÖzelHttpApi
DB2	Essbase	EventHub
Excel	Exchange	Uzantı
Facebook	File	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	Web

gatewayId

string

İ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

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ının 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

Enumeration

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

Değer	Description
None
Organizational
Private
Public

PublishDatasourceToGatewayRequest

Object

Ağ geçidi isteğine veri kaynağı 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

İzinler

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

Ek kaynaklar