다음을 통해 공유

Datasets - Bind To Gateway In Group

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

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

중요

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

사용 권한

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Dataset.ReadWrite.All

제한 사항

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

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

URI 매개 변수

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

string

데이터 세트 ID
groupId
 path True

string

uuid

작업 영역 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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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와 유사합니다.