Aracılığıyla paylaş

Datasets - Bind To Gateway

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

Çalışma alanım'dan 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.

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/datasets/{datasetId}/Default.BindToGateway

URI Parametreleri

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

string

Veri kümesi 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/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

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.