Datasets - Discover Gateways

Service:

Power BI REST APIs

API Version:

v1.0

Mengembalikan daftar gateway yang dapat diikat oleh himpunan data yang ditentukan dari Ruang kerja saya .

Panggilan API ini hanya relevan dengan himpunan data yang memiliki setidaknya satu koneksi lokal. Untuk himpunan data dengan koneksi khusus cloud, panggilan API ini mengembalikan daftar kosong.

Cakupan yang Diperlukan

Himpunan data.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.DiscoverGateways

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string	ID himpunan data

Respons

Nama	Jenis	Deskripsi
200 OK	Gateways	OK

Contoh

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "ContosoGateway",
      "type": "Resource",
      "publicKey": {
        "exponent": "AQAB",
        "modulus": "o6j2....cLk="
      }
    }
  ]
}

Definisi

Nama	Deskripsi
Gateway	Gateway Power BI
GatewayPublicKey	Kunci publik gateway Power BI
Gateways	Pembungkus respons OData untuk daftar gateway Power BI

Gateway

Gateway Power BI

Nama	Jenis	Deskripsi
gatewayAnnotation	string	Metadata gateway dalam format JSON
gatewayStatus	string	Status konektivitas gateway
id	string	ID gateway. Saat menggunakan kluster gateway, ID gateway mengacu pada gateway utama (pertama) di kluster dan mirip dengan ID kluster gateway.
name	string	Nama gateway
publicKey	GatewayPublicKey	Kunci publik gateway
type	string	Jenis gateway

GatewayPublicKey

Kunci publik gateway Power BI

Nama	Jenis	Deskripsi
exponent	string	Eksponen kunci publik
modulus	string	Modul kunci publik

Gateways

Pembungkus respons OData untuk daftar gateway Power BI

Nama	Jenis	Deskripsi
odata.context	string
value	Gateway[]	Daftar gateway