Datasets - Bind To Gateway

サービス:
Power BI REST APIs
API バージョン:
v1.0

指定したセマンティック モデルを、必要に応じて特定のデータ ソース ID のセットを使用して、指定したゲートウェイにバインドします。 呼び出し元に必要なアクセス許可がある場合、セマンティック モデルは My ワークスペース または別のワークスペースに存在できます。 特定のデータ ソース ID を指定しない場合、セマンティック モデルはゲートウェイ内の最初の一致するデータ ソースにバインドされます。

重要

API 呼び出し元プリンシパルをデータ ソース ユーザーとしてゲートウェイに追加します。

必要なスコープ

Dataset.ReadWrite.All

制限事項

オンプレミス データ ゲートウェイのみをサポートします

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

URI パラメーター

名前 / 必須 型 説明
datasetId
 path True

string

データセット ID

要求本文

名前 必須 型 説明
gatewayObjectId True

string (uuid)

ゲートウェイ ID。 ゲートウェイ クラスターを使用する場合、ゲートウェイ ID はクラスター内のプライマリ (最初の) ゲートウェイを参照し、ゲートウェイ クラスター ID と似ています。
datasourceObjectIds

string[] (uuid)

ゲートウェイ内のデータ ソースの一意の識別子

応答

名前 型 説明
200 OK

わかりました

例

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

要求のサンプル

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

応答のサンプル

状態コード:
200

Example without 'datasourceObjectIds'

要求のサンプル

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

応答のサンプル

状態コード:
200

定義

BindToGatewayRequest

Object

ゲートウェイ要求へのデータセットのバインド

名前 型 説明
datasourceObjectIds

string[] (uuid)

ゲートウェイ内のデータ ソースの一意の識別子
gatewayObjectId

string (uuid)

ゲートウェイ ID。 ゲートウェイ クラスターを使用する場合、ゲートウェイ ID はクラスター内のプライマリ (最初の) ゲートウェイを参照し、ゲートウェイ クラスター ID と似ています。