Aracılığıyla paylaş

Datasets - Bind To Gateway In Group

  • Başvuru
Service:
Power BI REST APIs
API Version:
v1.0

Belirtilen çalışma alanından belirtilen veri kümesini, isteğe bağlı olarak belirli bir veri kaynağı kimlikleri kümesiyle belirtilen ağ geçidine bağlar. Belirli bir veri kaynağı kimliği sağlamazsanız, veri kümesi ağ geçidindeki ilk eşleşen veri kaynağına bağlanır.

Önemli

API çağıran sorumlusunu ağ geçidine veri kaynağı kullanıcısı olarak ekleyin.

İzinler

Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

Yalnızca şirket içi veri ağ geçidini destekler

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

URI Parametreleri

Name İçinde Gerekli Tür Description
datasetId
 path True

string

Veri kümesi kimliği
groupId
 path True

string

uuid

Çalışma alanı kimliği

İstek Gövdesi

Name Gerekli Tür Description
gatewayObjectId True

string

Ağ geçidi kimliği. Ağ geçidi kümesi kullanılırken, ağ geçidi kimliği kümedeki birincil (ilk) ağ geçidine başvurur ve ağ geçidi küme kimliğine benzer.
datasourceObjectIds

string[]

Ağ geçidindeki veri kaynaklarının benzersiz tanımlayıcıları

Yanıtlar

Name Tür Description
200 OK

Tamam

Örnekler

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

Tanımlar

BindToGatewayRequest

Veri kümesini ağ geçidi isteğine bağlama

Name Tür Description
datasourceObjectIds

string[]

Ağ geçidindeki veri kaynaklarının benzersiz tanımlayıcıları
gatewayObjectId

string

Ağ geçidi kimliği. Ağ geçidi kümesi kullanılırken, ağ geçidi kimliği kümedeki birincil (ilk) ağ geçidine başvurur ve ağ geçidi küme kimliğine benzer.