Datasets - Discover Gateways

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

Zwraca listę bram, z którymi można powiązać określony model semantyczny. Model semantyczny może znajdować się w obszarze Mój obszar roboczy lub inny obszar roboczy, pod warunkiem, że obiekt wywołujący ma wymagane uprawnienia.

To wywołanie interfejsu API dotyczy tylko 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ę.

Wymagany zakres

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Objekt

Brama usługi Power BI

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

GatewayPublicKey

Objekt

Klucz publiczny bramy usługi Power BI

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

Gateways

Objekt

Otoka odpowiedzi OData dla listy bram usługi Power BI

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