Datasets - Discover Gateways In Group

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę bram, z którymi można powiązać określony zestaw danych z określonego obszaru roboczego.

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ę.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Dataset.Read.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych
groupId	path	True	string uuid	Identyfikator obszaru roboczego

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Gateways	OK

Przykłady

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

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	Modulu klucza publicznego

Gateways

Otoka odpowiedzi OData dla listy bram usługi Power BI

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