Datasets - Discover Gateways

Служба:

Power BI REST APIs

Версия API:

v1.0

Возвращает список шлюзов, к которым можно привязать указанный набор данных из моей рабочей области .

Этот вызов API относится только к наборам данных, имеющим по крайней мере одно локальное подключение. Для наборов данных с облачными подключениями вызов API возвращает пустой список.

Требуемая область

Dataset.Read.All

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string	Идентификатор набора данных

Ответы

Имя	Тип	Описание
200 OK	Gateways	ХОРОШО

Примеры

Example

Образец запроса

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

Пример ответа

Код состояния:

200

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

Определения

Имя	Описание
Gateway	Шлюз Power BI
GatewayPublicKey	Открытый ключ шлюза Power BI
Gateways	Оболочка ответа OData для списка шлюзов Power BI

Gateway

Object

Шлюз Power BI

Имя	Тип	Описание
gatewayAnnotation	string	Метаданные шлюза в формате JSON
gatewayStatus	string	Состояние подключения шлюза
id	string (uuid)	Идентификатор шлюза. При использовании кластера шлюза идентификатор шлюза ссылается на первичный (первый) шлюз в кластере и аналогичен идентификатору кластера шлюза.
name	string	Имя шлюза
publicKey	GatewayPublicKey	Открытый ключ шлюза
type	string	Тип шлюза

GatewayPublicKey

Object

Открытый ключ шлюза Power BI

Имя	Тип	Описание
exponent	string	Экспонент открытого ключа
modulus	string	Модуль открытого ключа

Gateways

Object

Оболочка ответа OData для списка шлюзов Power BI

Имя	Тип	Описание
@odata.context	string
value	Gateway[]	Список шлюзов