Bagikan melalui

Datasets - Bind To Gateway

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

Mengikat himpunan data yang ditentukan dari Ruang kerja saya ke gateway yang ditentukan, secara opsional dengan sekumpulan ID sumber data tertentu. Jika Anda tidak menyediakan ID sumber data tertentu, himpunan data akan terikat ke sumber data pertama yang cocok di gateway.

Penting

Tambahkan prinsipal pemanggil API sebagai pengguna sumber data di gateway.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

Batasan

Hanya mendukung gateway data lokal

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
 path True

string

ID himpunan data

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
gatewayObjectId True

string

ID gateway. Saat menggunakan kluster gateway, ID gateway mengacu pada gateway utama (pertama) di kluster dan mirip dengan ID kluster gateway.
datasourceObjectIds

string[]

Pengidentifikasi unik untuk sumber data di gateway

Respons

Nama Jenis Deskripsi
200 OK

OK

Contoh

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

Definisi

BindToGatewayRequest

Himpunan data yang diikat ke permintaan gateway

Nama Jenis Deskripsi
datasourceObjectIds

string[]

Pengidentifikasi unik untuk sumber data di gateway
gatewayObjectId

string

ID gateway. Saat menggunakan kluster gateway, ID gateway mengacu pada gateway utama (pertama) di kluster dan mirip dengan ID kluster gateway.