Bagikan melalui

Datasets - Bind To Gateway In Group

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
v1.0

Mengikat himpunan data yang ditentukan dari ruang kerja yang ditentukan ke gateway yang ditentukan, secara opsional dengan sekumpulan ID sumber data tertentu. Jika Anda tidak memberikan 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.

Hak akses

Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Himpunan Data.ReadWrite.All

Keterbatasan

Hanya mendukung gateway data lokal 

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
 path True

string

ID himpunan data
groupId
 path True

string (uuid)

ID ruang kerja

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
gatewayObjectId True

string (uuid)

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

string[] (uuid)

Pengidentifikasi unik untuk sumber data di gateway

Respons

Nama Jenis Deskripsi
200 OK

OK

Contoh

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

Permintaan sampel

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

Respon sampel

Kode status:
200

Example without 'datasourceObjectIds'

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Isi Permintaan
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Respon sampel

Kode status:
200

Definisi

BindToGatewayRequest

Objek

Himpunan data terikat ke permintaan gateway

Nama Jenis Deskripsi
datasourceObjectIds

string[] (uuid)

Pengidentifikasi unik untuk sumber data di gateway
gatewayObjectId

string (uuid)

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