Gateways - Get Datasources

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

URI 매개 변수

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

응답

Name	형식	Description
200 OK	GatewayDatasources	정상

예제

Example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
      "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "datasourceType": "Sql",
      "connectionDetails": "{\"server\":\"localSQL\",\"database\":\"salesDB\"}",
      "credentialType": "Windows",
      "datasourceName": "SQL Datasource"
    },
    {
      "id": "91f8aec2-4b32-476f-909b-3241999620ec",
      "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "datasourceType": "AnalysisServices",
      "connectionDetails": "{\"server\":\"localAS\",\"database\":\"marketingDB\"}",
      "credentialType": "Windows",
      "datasourceName": "AS Datasource"
    }
  ]
}

정의

Name	Description
credentialType	데이터 원본 자격 증명의 형식
GatewayDatasource	Power BI 게이트웨이 데이터 원본
GatewayDatasourceCredentialDetails	데이터 원본 자격 증명 세부 정보
GatewayDatasources	Power BI 게이트웨이 데이터 원본 컬렉션에 대한 OData 응답 래퍼

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)를 지원하는 데이터 원본과 함께 사용합니다.

GatewayDatasources

Power BI 게이트웨이 데이터 원본 컬렉션에 대한 OData 응답 래퍼

Name	형식	Description
odata.context	string	OData 컨텍스트
value	GatewayDatasource[]	게이트웨이 데이터 원본 목록