Gateways - Get Datasource

Service:

Power BI REST APIs

API Version:

v1.0

지정된 게이트웨이에서 지정된 데이터 원본을 반환합니다.

사용 권한

사용자에게 게이트웨이 관리자 권한이 있어야 합니다.

필수 범위

Dataset.ReadWrite.All 또는 Dataset.Read.All

제한 사항

VNet(가상 네트워크) 게이트웨이는 지원되지 않습니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasourceId	path	True	string uuid	데이터 원본 ID
gatewayId	path	True	string uuid	게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조합니다. 이러한 경우 게이트웨이 ID는 게이트웨이 클러스터 ID와 유사합니다.

응답

Name	형식	Description
200 OK	GatewayDatasource	정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970

Sample Response

Status code:

200

{
  "id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
  "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceType": "Sql",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "credentialType": "Windows",
  "datasourceName": "Sample Datasource"
}

정의

Name	Description
credentialType	데이터 원본 자격 증명의 형식
GatewayDatasource	Power BI 게이트웨이 데이터 원본
GatewayDatasourceCredentialDetails	데이터 원본 자격 증명 세부 정보

credentialType

데이터 원본 자격 증명의 형식

Name	형식	Description
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

GatewayDatasource

Power BI 게이트웨이 데이터 원본

Name	형식	Description
connectionDetails	string	JSON 형식의 연결 세부 정보
credentialDetails	GatewayDatasourceCredentialDetails	업데이트가 필요한 데이터 원본에 대한 연결 세부 정보입니다. 데이터 세트에 둘 이상의 데이터 원본이 있는 경우 연결 세부 정보는 필수입니다.
credentialType	credentialType	데이터 원본 자격 증명의 형식
datasourceName	string	데이터 원본의 이름입니다.
datasourceType	string	데이터 원본의 형식입니다. 데이터 원본의 API 이름 ActiveDirectory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Exchange 내선 번호 Facebook 파일 폴더 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 웹
gatewayId	string	연결된 게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.
id	string	데이터 원본의 고유 ID

GatewayDatasourceCredentialDetails

데이터 원본 자격 증명 세부 정보

Name	형식	Description
useEndUserOAuth2Credentials	boolean	DirectQuery 모드에서 데이터 원본에 연결할 때 최종 사용자 Azure AD ID(OAuth 2.0 자격 증명)가 사용되는지 여부입니다. SSO(Single Sign-On)를 지원하는 데이터 원본과 함께 사용합니다.