Gateways - Create Datasource

Služba:: Power BI REST APIs

Verze rozhraní API:: v1.0

Vytvoří nový zdroj dat na zadané místní bráně.

Přihlašovací údaje místního zdroje dat musí být šifrované. Parametr encryptedConnection musí být nastavený na Encrypted a přihlašovací údaje by měly být šifrované pomocí veřejného klíče brány.

Příklad použití tohoto rozhraní API najdete v vytvoření zdroje dat brány skript PowerShellu. Tento skript používá skript PowerShellu uvedený v poznámce níže k šifrování přihlašovacích údajů.

Poznámka:

Pokud chcete šifrovat přihlašovací údaje, přečtěte si téma Konfigurace přihlašovacích údajů programově pro Power BI a projděte si příklady .NET Core. Java, Python a PowerShellu.

Dovolení

Podporuje pouze místní brány a uživatel musí mít oprávnění správce brány.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Virtuální síť (VNet) a cloudové brány se nepodporují.
OAuth2 jako typ přihlašovacích údajů se nepodporuje.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
gatewayId	path	True	string (uuid)	ID brány. Při použití clusteru brány odkazuje ID brány na primární (první) bránu v clusteru. V takových případech se ID brány podobá ID clusteru brány.

Text požadavku

Name	Vyžadováno	Typ	Description
connectionDetails	True	string	Podrobnosti o připojení
credentialDetails	True	CredentialDetails	Podrobnosti přihlašovacích údajů
dataSourceName	True	string	Název zdroje dat
dataSourceType	True	string	Typ zdroje dat

Odpovědi

Name	Typ	Description
201 Created	GatewayDatasource	Vytvořeno

Příklady

Azure Analysis Services example

SQL example

Azure Analysis Services example

Ukázkový požadavek

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

Text požadavku

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

Ukázková odpověď

Stavový kód:: 200

SQL example

Ukázkový požadavek

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

Text požadavku

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

Ukázková odpověď

Stavový kód:: 200

Definice

Name	Description
CredentialDetails	Podrobnosti přihlašovacích údajů
credentialType	Typ zdroje dat přihlašovacích údajů
encryptedConnection	Určuje, jestli se má šifrovat připojení ke zdroji dat. Volání rozhraní API selže, pokud vyberete šifrování a Power BI nemůže navázat šifrované připojení ke zdroji dat.
encryptionAlgorithm	Šifrovací algoritmus. Pro cloudový zdroj dat zadejte `None`. Pro místní zdroj dat zadejte `RSA-OAEP` a použijte veřejný klíč brány k šifrování přihlašovacích údajů.
GatewayDatasource	Zdroj dat brány Power BI
GatewayDatasourceCredentialDetails	Podrobnosti přihlašovacích údajů ke zdroji dat
privacyLevel	Úroveň ochrany osobních údajů, která je relevantní při kombinování dat z více zdrojů.
PublishDatasourceToGatewayRequest	Publikování zdroje dat do žádosti o bránu

CredentialDetails

Objekt

Podrobnosti přihlašovacích údajů

Name	Typ	Description
credentialType	credentialType	Typ přihlašovacích údajů
credentials	string	Přihlašovací údaje, které závisí na hodnotě credentialType. Další informace najdete v příkladech aktualizace zdroje dat.
encryptedConnection	encryptedConnection	Určuje, jestli se má šifrovat připojení ke zdroji dat. Volání rozhraní API selže, pokud vyberete šifrování a Power BI nemůže navázat šifrované připojení ke zdroji dat.
encryptionAlgorithm	encryptionAlgorithm	Šifrovací algoritmus. Pro cloudový zdroj dat zadejte `None`. Pro místní zdroj dat zadejte `RSA-OAEP` a použijte veřejný klíč brány k šifrování přihlašovacích údajů.
privacyLevel	privacyLevel	Úroveň ochrany osobních údajů, která je relevantní při kombinování dat z více zdrojů.
useCallerAADIdentity	boolean	Určuje, jestli se identita Azure AD (přihlašovací údaje OAuth 2.0) volajícího rozhraní API (který musí být vlastníkem zdroje dat), použije ke konfiguraci přihlašovacích údajů ke zdroji dat (přístupový token OAuth vlastníka). Obvykle byste použili tento příznak nebo `useEndUserOAuth2Credentials`.
useEndUserOAuth2Credentials	boolean	Určuje, jestli se identita Azure AD koncového uživatele (přihlašovací údaje OAuth 2.0) používá při připojování ke zdroji dat v režimu DirectQuery. Používá se se zdroji dat, které podporují jednotného přihlašování. Obvykle byste použili tento příznak nebo `useCallerAADIdentity`.

credentialType

Výčet

Typ zdroje dat přihlašovacích údajů

Hodnota	Description
Basic
Windows
Anonymous
OAuth2
Key
SAS
KeyPair

encryptedConnection

Výčet

Určuje, jestli se má šifrovat připojení ke zdroji dat. Volání rozhraní API selže, pokud vyberete šifrování a Power BI nemůže navázat šifrované připojení ke zdroji dat.

Hodnota	Description
Encrypted
NotEncrypted

encryptionAlgorithm

Výčet

Šifrovací algoritmus. Pro cloudový zdroj dat zadejte None. Pro místní zdroj dat zadejte RSA-OAEP a použijte veřejný klíč brány k šifrování přihlašovacích údajů.

Hodnota	Description
None
RSA-OAEP

GatewayDatasource

Objekt

Zdroj dat brány Power BI

Name

Typ

Description

connectionDetails

string

Podrobnosti o připojení ve formátu JSON

credentialDetails

GatewayDatasourceCredentialDetails

Podrobnosti o připojení ke zdroji dat, který potřebuje aktualizaci. Podrobnosti o připojení jsou povinné, pokud datová sada obsahuje více než jeden zdroj dat.

credentialType

Typ zdroje dat přihlašovacích údajů

datasourceName

string

Název zdroje dat

datasourceType

string

Typ zdroje dat.

Název rozhraní API pro zdroj dat
ActiveDirectory	AdobeAnalytics	AdoDotNet
AnalysisServices	AzureBlobs	AzureDataLakeStorage
AzureMarketplace	AzureTables	BizTalk
CDPA	CustomConnector	CustomHttpApi
DB2	Essbase	EventHub
Excel	Výměna	Prodloužení
Facebook	Soubor	Složka
GoogleAnalytics	Hdfs	HDInsight
Informix	MQ	MySql
OData	rozhraní ODBC	OleDb
Oracle	PostgreSql	PowerQueryMashup
PubNub	Salesforce	SAPBW
SAPBWMessageServer	SapErp	SAPHana
SharePoint	SharePointDocLib	SharePointList
Sql	Sybase	Teradata
UiFlow	web

gatewayId

string (uuid)

PŘIDRUŽENÉ ID brány. Při použití clusteru brány odkazuje ID brány na primární (první) bránu v clusteru a podobá se ID clusteru brány.

string (uuid)

Jedinečné ID zdroje dat

GatewayDatasourceCredentialDetails

Objekt

Podrobnosti přihlašovacích údajů ke zdroji dat

Name	Typ	Description
useEndUserOAuth2Credentials	boolean	Určuje, jestli se identita Azure AD koncového uživatele (přihlašovací údaje OAuth 2.0) používá při připojování ke zdroji dat v režimu DirectQuery. Používá se se zdroji dat, které podporují jednotného přihlašování.

privacyLevel

Výčet

Úroveň ochrany osobních údajů, která je relevantní při kombinování dat z více zdrojů.

Hodnota	Description
None
Public
Organizational
Private

PublishDatasourceToGatewayRequest

Objekt

Publikování zdroje dat do žádosti o bránu

Name	Typ	Description
connectionDetails	string	Podrobnosti o připojení
credentialDetails	CredentialDetails	Podrobnosti přihlašovacích údajů
dataSourceName	string	Název zdroje dat
dataSourceType	string	Typ zdroje dat