Gateways - Create Datasource

Başvuru

Service:: Power BI REST APIs

API Version:: 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

Sample Request

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

Request Body

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

Sample Response

Status code:: 200

SQL example

Sample Request

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

Request Body

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

Sample Response

Status code:: 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

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

Veri kaynağı kimlik bilgilerinin türü

Name	Tür	Description
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

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.

Name	Tür	Description
Encrypted	string
NotEncrypted	string

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.

Name	Tür	Description
None	string
RSA-OAEP	string

GatewayDatasource

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

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

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

Name	Tür	Description
None	string
Organizational	string
Private	string
Public	string

PublishDatasourceToGatewayRequest

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

Sample Request

Sample Response

SQL example

Sample Request

Sample Response

Tanımlar

CredentialDetails

credentialType

encryptedConnection

encryptionAlgorithm

GatewayDatasource

GatewayDatasourceCredentialDetails

privacyLevel

PublishDatasourceToGatewayRequest

Ek kaynaklar