Datasets - Discover Gateways In Group

Service:

Power BI REST APIs

API Version:

v1.0

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

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

Разрешения

Этот вызов API может вызываться профилем субъекта-службы. Дополнительные сведения см. в разделе "Профили субъектов-служб" в Power BI Embedded.

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

Dataset.Read.All

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

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	Gateways	ОК

Примеры

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

Sample Response

Status code:

200

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

Определения

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

Gateway

Шлюз Power BI

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

GatewayPublicKey

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

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

Gateways

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

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