다음을 통해 공유

Datasets - Bind To Gateway

  • 참조
Service:
Power BI REST APIs
API Version:
v1.0

지정된 데이터 원본 ID 집합을 사용하여 필요에 따라 내 작업 영역 의 지정된 데이터 세트를 지정된 게이트웨이에 바인딩합니다. 특정 데이터 원본 ID를 제공하지 않으면 데이터 세트가 게이트웨이에서 일치하는 첫 번째 데이터 원본에 바인딩됩니다.

중요

게이트웨이에서 데이터 원본 사용자로 API 호출자 주체를 추가합니다.

필수 범위

Dataset.ReadWrite.All

제한 사항

온-프레미스 데이터 게이트웨이만 지원합니다.

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.BindToGateway

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
datasetId
 path True

string

데이터 세트 ID

요청 본문

Name 필수 형식 Description
gatewayObjectId True

string

게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.
datasourceObjectIds

string[]

게이트웨이의 데이터 원본에 대한 고유 식별자

응답

Name 형식 Description
200 OK

정상

예제

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Request Body
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceObjectIds": [
    "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb",
    "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
  ]
}

Sample Response

Status code:
200

Example without 'datasourceObjectIds'

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Request Body
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Sample Response

Status code:
200

정의

BindToGatewayRequest

게이트웨이 요청에 데이터 세트 바인딩

Name 형식 Description
datasourceObjectIds

string[]

게이트웨이의 데이터 원본에 대한 고유 식별자
gatewayObjectId

string

게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.