Datasets - Discover Gateways

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę bram, z którymi można powiązać określony zestaw danych z obszaru Mój obszar roboczy .

To wywołanie interfejsu API jest istotne tylko dla zestawów danych, które mają co najmniej jedno połączenie lokalne. W przypadku zestawów danych z połączeniami tylko w chmurze to wywołanie interfejsu API zwraca pustą listę.

Zakres wymagany

Dataset.Read.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Gateways	OK

Przykłady

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="
      }
    }
  ]
}

Definicje

Nazwa	Opis
Gateway	Brama usługi Power BI
GatewayPublicKey	Klucz publiczny bramy usługi Power BI
Gateways	Otoka odpowiedzi OData dla listy bram usługi Power BI

Gateway

Brama usługi Power BI

Nazwa	Typ	Opis
gatewayAnnotation	string	Metadane bramy w formacie JSON
gatewayStatus	string	Stan łączności bramy
id	string	Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do podstawowej (pierwszej) bramy w klastrze i jest podobny do identyfikatora klastra bramy.
name	string	Nazwa bramy
publicKey	GatewayPublicKey	Klucz publiczny bramy
type	string	Typ bramy

GatewayPublicKey

Klucz publiczny bramy usługi Power BI

Nazwa	Typ	Opis
exponent	string	Wykładnik klucza publicznego
modulus	string	Modulo klucza publicznego

Gateways

Otoka odpowiedzi OData dla listy bram usługi Power BI

Nazwa	Typ	Opis
odata.context	string
value	Gateway[]	Lista bram