Datasets - Discover Gateways

Service:

Power BI REST APIs

API Version:

v1.0

내 작업 영역에서 지정된 데이터 세트를 바인딩할 수 있는 게이트웨이 목록을 반환합니다.

이 API 호출은 하나 이상의 온-프레미스 연결이 있는 데이터 세트와만 관련이 있습니다. 클라우드 전용 연결이 있는 데이터 세트의 경우 이 API 호출은 빈 목록을 반환합니다.

필수 범위

Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.DiscoverGateways

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string	데이터 세트 ID

응답

Name	형식	Description
200 OK	Gateways	정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "ContosoGateway",
      "type": "Resource",
      "publicKey": {
        "exponent": "AQAB",
        "modulus": "o6j2....cLk="
      }
    }
  ]
}

정의

Name	Description
Gateway	Power BI 게이트웨이
GatewayPublicKey	Power BI 게이트웨이 공개 키
Gateways	Power BI 게이트웨이 목록에 대한 OData 응답 래퍼

Gateway

Power BI 게이트웨이

Name	형식	Description
gatewayAnnotation	string	JSON 형식의 게이트웨이 메타데이터
gatewayStatus	string	게이트웨이 연결 상태
id	string	게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.
name	string	게이트웨이 이름
publicKey	GatewayPublicKey	게이트웨이 공개 키
type	string	게이트웨이 유형

GatewayPublicKey

Power BI 게이트웨이 공개 키

Name	형식	Description
exponent	string	공개 키 지수
modulus	string	공개 키 모듈러스

Gateways

Power BI 게이트웨이 목록에 대한 OData 응답 래퍼

Name	형식	Description
odata.context	string
value	Gateway[]	게이트웨이 목록